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译 者 序 


Android 是 Google 公司 基于 Linux 平台 开发 的 开源 手机 操作 系统 ， 自 然 要 对 C、C++ 
提供 原生 的 支持 。 通 过 Google 发 布 的 Android 手机 NDK(Native Development Kit)， 应 用 程 
序 可 以 非常 方便 地 实现 Java 与 C/C++ 代码 的 相互 沟通 。 合 理 地 使 用 NDK， 可 以 提高 应 用 
程序 的 执行 效率 。 所 以 ， 对 于 Android 开发 人 员 来 说 ，NDK 是 必须 掌握 的 工具 。 

本 书 的 作者 Onur Cinar 在 美国 宾 州 费城 Drexel 大 学 获得 计算 机 科学 理学 学 士 学 位 。 他 
有 17 年 的 移动 通信 和 领域 大 规模 复杂 软件 项 目的 设计 、 开 发 和 管理 经 验 。 自 Android 平台 问 
世 以 来 ，Onur Cinar 一 直 积 极 从 事 Android 开发 工作 ， 目 前 在 微软 Skype 分 部 担任 Android 
平台 的 Skype 客户 端 高 级 产品 工程 经 理 。 出 版 了 多 部 Android 开发 应 用 方面 的 图 书 。 

本 书 提供 了 Android NDK 开发 的 全 面 信息 ， 介 绍 了 从 NDK 开发 环境 搭建 的 每 一 步 细 
节 ，NDK 的 基本 概念 和 体系 结构 ， 具 体 的 开发 流程 和 方法 。 同 时 还 比较 详尽 地 介绍 了 
Android NDK 对 C、C++ 标 准 库 的 支持 。 是 一 本 关于 Android NDK 开发 的 全 新 入 门 指南 。 

本 书 译 者 团队 具有 丰富 的 系统 设计 与 开发 经 验 。 于 红 在 计算 机 应 用 技术 领域 工作 20 
余年 ， 承 担 Java 语言 程序 设计 、Visual Basic 等 程序 设计 、 操 作 系统 等 课程 的 教学 任务 ， 
熟悉 程序 设计 类 课程 的 教学 规律 ， 具 有 较 强 的 语言 组 织 和 语言 表达 能 力 ， 在 国内 外 期 刊 及 
知名 国际 会 议 上 发 表 论文 40 余 篇 ， 其 中 被 三 大 检索 收录 22 篇 ， 出 版 教材 3 部 。 余 建 伟 先 
后 就 职 于 腾讯 (大 连 ) 无 线 研 发 中 心 和 东软 (大 连 ) 集 团 有 限 公司 。 主 要 从 事 移动 互联 网 应 用 开 
发 以 及 嵌入 式 产 品 的 设计 和 开发 。 从 2010 年 至 今 一 直 从 事 Android 应 用 与 游戏 开发 和 
Framework 内 核 以 及 Android 底层 开发 技术 的 研究 ， 对 Android 内 核 有 较为 深刻 的 理解 。 
此 外 对 移动 互联 网 产品 交互 设计 和 产品 运营 也 有 一 定 的 研究 。 目 前 已 出 版 一 本 详 著 

《Android 4 高 级 编程 (第 3 版 )》。 汉 艳 红 从 事 计 算 机 应 用 技术 教学 及 研究 工作 7 年 多 ， 主 
要 承担 Java 语言 程序 设计 、C 语言 程序 设计 、C++ 面 向 对 象 的 程序 设计 等 课程 的 教学 工作 ， 
参与 了 多 个 项 目的 开发 ， 具 有 较 强 的 理论 基础 和 程序 开发 经 验 。 

于 红 负 责 翻译 第 3 一 10 章 ， 余 建 伟 负责 翻译 第 11 一 14 章 ， 冯 艳 红 负责 翻译 第 1 章 、 第 
2 章 、 前 言 、 内 封 、 封 底 等 。 参 与 翻译 活动 的 还 有 孙 庚 、 王 芳 、 黄 璐 、 史 鹏 辉 、 崔 春雷 、 
何 南 、 孙 京 恩 、 王 美 妮 ; 另外 李 青 、 孔 亮 亮 、 王 宁 三 位 同学 协助 完成 本 书 部 分 内 容 的 翻译 ， 
没有 他 们 的 帮助 不 可 能 完成 本 书 的 翻译 工作 , 在 此 对 他 们 表示 衷心 的 感谢 。 由 于 时 间 仓促 、 
译 者 的 水 平 及 精力 有 限 ， 一 定 存在 廖 误 ， 希 望 读者 们 多 多 批评 指正 。 


译 者 


作者 简介 


Onur Cinar 有 超过 17 年 的 移动 和 通信 和 领域 大 规模 复杂 软件 项 目 
的 设计 、 开 发 和 管理 经 验 。 他 的 专业 技能 包括 VoIP、 视 频 通信 、 移 
动 应 用 程序 、 网 格 计算 和 不 同 平台 上 的 网 络 技术 。 从 Android 平台 
问世 他 就 一 直 积 极 从 事 这 方面 的 工作 。 他 是 Apress 出 版 的 4ndroid 
Apps with Eclipse 一 书 的 作者 。 他 在 美国 宾 州 费城 Drexel 大 学 获得 
计算 机 科学 理学 学 士 学 位 。 现 就 职 于 微软 Skype 分 部 ， 任 Android 
平台 的 Skype 客户 端 高 级 产品 工程 经 理 。 


技术 审 校 者 简介 


Grant Allen 在 IT 领域 工作 了 20 年 ， 主 要 职位 是 CTO、 企 
业 架 构 师 和 数据 库 架 构 师 。 他 曾经 在 全 球 各 地 的 私企 、 学 术 界 
和 政府 部 门 工作 过 ， 专 长 是 进行 全 球 通用 的 系统 设计 、 开 发 和 
性 能 优化 。 他 经 常 在 产业 界 和 学 术 界 的 会 议 上 发 言 ， 涉 及 的 主 
题 从 数据 挖掘 到 兼容 性 ， 以 及 诸如 数据 库 (DB2、Oracle、SQL 
Server 以 及 MySQL)， 内 容 管理 ， 协 作 ， 颠 覆 性 的 创新 和 像 
Android 这 样 的 移动 生态 系统 之 类 的 技术 。 

他 的 第 一 个 Android 应 用 程序 是 一 个 提醒 他 完成 所 有 其 他 
未 完成 的 Android 项 目的 任务 列表 。 

Grant 在 谷歌 工作 ， 利 用 空闲 时 间 攻 读 博士 学 位 ， 博 士 论 文 的 研究 题目 是 构建 创新 性 
的 高 技术 环境 。 

他 是 Beginning DB2: From Novice to Professional (Apress, 2008) 的 作者 ，Oracle SOL 
Recipes: A Problem-Solution Approach (Apress, 2010) 和 The Definitive Guide to SOLite, 2nd 
Edition (Apress, 2010) 的 主编 。 
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Android 是 移动 电话 市 场 的 主要 角色 而 且 其 市 场 份 额 正在 持续 增长 。 它 是 第 一 个 完整 
的 、 开 放 的 、 免 费 的 移动 平台 ， 该 平台 给 移动 应 用 开发 者 提供 了 无 限 的 机 会 。 

虽然 Android 平台 的 官方 程序 语言 是 Java， 但 应 用 开发 者 不 限于 仅 使 用 Java 技术 。 

Android 允许 应 用 开发 者 通过 Android 原生 开发 包 (GNDK) 使 用 诸如 C 和 C++ 之 类 的 原生 
代码 语言 实现 他 们 的 部 分 应 用 。 本 书 中 我 们 将 学 习 如 何 用 Android NDK 通过 原生 代码 语言 
去 实现 自己 的 Android 应 用 中 对 性 能 要 求 较 高 的 部 分 。 

本 书 介 绍 了 原生 应 用 开发 、 可 用 的 原生 API 以 及 故障 排除 技术 的 详细 叙述 ， 包 括 用 
按 步骤 的 指导 和 屏幕 截图 以 帮助 Android 开发 人 员 迅速 达到 开发 原生 应 用 的 目的 。 


主要 内 容 : 


在 主要 的 操作 系统 上 安装 Android 原生 开发 环境 。 
使 用 Eclipse 集成 开发 环境 开发 原生 代码 。 

使 用 Java 原生 接口 (JIND 将 原生 代码 与 Java 代码 连接 。 
用 SWIG 自动 生成 JNI 代码 。 

用 POSIX 和 Java 线程 开发 多 线程 原生 应 用 。 

用 POSIX sockets 开发 网 络 原生 应 用 。 

用 logging、GDB 和 Eclipse 调试 器 调试 原生 代码 。 

用 Valgrind 分 析 内 存 问 题 。 

用 GProf 测试 应 用 性 能 。 

用 SIMD/NEON 优化 原生 代码 。 


下 载 代码 
读者 可 以 在 www.apress.com 上 下 载 本 书 源 代码 。 


联系 作者 


读者 可 以 通过 作者 的 Android C++ with the NDK 网 站 http://www.zdo.com/android- 
c++-with-the-ndk 联系 作者 。 
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第 章 


Android 平台 上 的 C++ 人 入门 


毋庸 署 疑 ， 探 索 和 实践 是 学 习 的 最 佳 方法 。 本 书 一 开始 就 为 读者 讲解 功能 完备 的 开发 
环境 , 使 读者 可 以 在 以 后 各 章 的 学 习 过 程 中 用 实例 进行 探索 和 实验 。 Android C++ 开发 环境 
主要 由 以 下 儿 部 分 构成 : 


Android 软件 开发 包 (Software Development Kit，SDK) 

Android 原生 开发 包 (Native Development Kit,，NDK) 

Eclipse 上 的 Android 开发 工具 (Android Development Tools，ADT) 插 件 
Java 开发 包 (Java Development Kit，JDK) 

Apache ANT 构建 系统 

GNU Make 构建 系统 

Eclipse IDE 


本 章 循 序 渐进 地 讲解 正确 配置 Android C++ 开发 环境 的 步骤 ,Android 开发 工具 可 以 在 
以 下 三 种 操作 系统 平台 上 运行 : 


Microsoft Windows 
Apple Mac OS X 
Linux 


由 于 不 同 操作 系统 的 需求 和 安装 步骤 差异 较 大 ， 因 此 下 面 将 分 别 阐述 不 同 操作 系统 上 
Android C++ 开发 环境 的 安装 步骤 ， 可 以 跳 过 你 不 使 用 的 操作 系统 。 


不 1 


Microsoft Windows 


Android 开发 工具 可 以 在 Windows XP( 仅 限于 32 位 )、Vista 或 Windows 7 中 运行 。 在 
本 节 中 你 需要 下 载 并 安装 以 下 组 件 : 


Java JDK 6 
Apache ANT 构建 系统 
Android SDK 
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® Cygwin 
e Android NDK 
® Eclipse IDE 


1.1.1 在 Windows 平台 上 下 载 并 安装 JDK 开发 包 


Android 开发 工具 要 求 必须 安装 JDK(Java Development Kib, 不 能 只 安装 JRE(Java Runtime 
Edition)， 在 安装 Android 开发 工具 之 前 需要 先 安装 Java JDK 6。 


注意 : 
为 遵守 上 述 版 本 号 ，Android 开发 工具 只 支持 版 本 5 或 者 6 的 Java 编译 器 。 用 JDK 6 
更 简单 且 不 易 出 错 。 


Android 开发 工具 支持 多 种 发 行 版 本 的 JDK， 例 如 : IBM JDK、Open JDK 以 及 Oracle 
JDK( 即 以 前 的 Sun JDK)。 因 为 Oracle JDK 支持 的 平台 较 多 ， 本 书 使 用 Oracle JDK 为 例 进 
行 讲解 。 

请 访问 www.oracle.com/technetwork/java/javase/downloads/index.html 网 站 , 按照 以 下 步 
又 下 载 Oracle JDK: 

(1) 如 图 1-1 所 示 , 单 击 JDK 6 下 载 按钮 开始 下 载 , 本 书 编写 时 最 新 版 本 的 Oracle JDK 6 
是 Update 33。 


OO Ee 


1-1 Oracle JDK 6 下 载 按 钮 


(2) 单 击 Oracle JDK 6 Download 按钮 之 后 进入 支持 平台 的 Oracle JDK 6 安装 包 清 单 页 面 。 
(3) 选中 Accept License Agreement 选项 并 下 载 Windows x86 安装 包 ， 如 图 1-2 所 示 。 


二 
ava SE Deveropment Kit Upaate 33 


men ecreten eed oe 
Py 


aceret bemm Agreement © Orchre bomm apmmmt 


图 1-2 下 载 Windows x86 下 的 Oracle JDK 6 
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现在 可 以 安装 了 。Windows 平台 下 的 Oracle JDK 6 安装 包 带 有 图 形 安装 向 导 ， 它 将 指 
导 你 完成 JDK 的 安装 。 安 装 向 导 首先 安装 JDK， 然 后 安装 耻 E。 在 安装 过 程 中 ， 安 装 向 导 
会 让 你 指定 安装 目录 以 及 要 安装 的 组 件 ， 如 图 1-3 所 示 。 当 然 ， 此 处 可 以 使 用 默认 值 。 此 
时 ， 要 记 住 JDK 的 安装 目录 以 备 环 境 变量 设置 时 使 用 。 


Sciect opfional feares to install from the lst below. You can chenge your dhoce of fcahres after 
natsllaton by usc tre AddRemove Prograne utity n the Conyol Panel 


C:\Program Fies (x86)\ovoVde1.6.0_35\ 


图 1-3 Oracle JDK 6 安装 目录 


安装 完成 时 JDK 准备 就 绪 ， 安 装 向 导 不 会 自动 将 Java 二 进 制 目录 加 入 系统 可 执行 文 
件 搜索 路 径 ， 即 PATH 环境 变量 中 ， 这 一 步 要 在 JDK 安装 的 最 后 一 步 手工 完成 : 

(1) 在 Start 按钮 菜单 中 选择 Control Panel。 

(2) 单 击 System 图 标 进入 System Properties 对 话 框 。 

(3) 单 击 Advanced 选项 卡 ， 然 后 单 击 此 选项 卡 中 的 Environment Variables 按钮 ， 如 
图 1-4 所 示 。 


You must be logged on as an Admrahalorto make most of these changes 
FPeromance 
Veual fects. processor scheding. memory usage. nd witual memory 


[se ] 


System satup system fahure. and debuggng rfomaton 


[ Satup and Recoven 


图 1-4 System Properties 对 话 框 
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(4) 单 击 Environment Variables 按钮 将 启动 Environment Variables 对 话 框 , 该 对 话 框 由 
两 部 分 构成 :上 面 是 User Environment Variables( 用 户 环境 变量 ), 下 面 是 System Environment 
Variables( 系 统 环 境 变量 )。 

(5) 在 系统 变量 部 分 单 击 New 按钮 定义 新 的 环境 变量 ， 如 图 1-5 所 示 。 


| Environment Variables 


PATHEXT 
PROCESSOR_A..， AMD64 


1-5 ”Environment Variables 对 话 框 


(6) 将 变量 名 设置 成 JAVA_HOME， 变 量 值 设 置 成 在 前 面 的 安装 过 程 中 记录 下 来 的 
Oracle JDK 的 安装 目录 ， 如 图 1-6 所 示 。 


New System Variable Ix| 
Variable name: [JAVA_HOME 


Variable value: [ C:\Program Files (x86) Yava\idk1.5.0_33\ 
EC 


图 1-6 新 的 JAVA_HOME 环境 变量 


(7) 单 击 OK 按钮 保存 环境 变量 。 
(8) 在 系统 变量 列表 中 ， 双 击 PATH 变量 ， 并 将 ;%JAVA_HOME%\bin 追加 到 变量 值 
后 面 ， 如 图 1-7 所 示 。 
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Edit System Variable Ix| 


Variable name: Path 


Variable yalue: Windows Lve\Shared;%JAVA_HONE%\bin 
man | EE 
图 1-7 将 Oracle JDK 二 进 制 路 径 追 加 到 系统 PATH 变量 中 


现在 Oracle JDK 成 为 系统 可 执行 文件 搜索 路 径 的 一 部 分 了 ， 且 该 地 址 很 容易 找到 。 为 
了 验证 安装 是 否 成 功 ， 选 择 Start | Accessories | Command Prompt， 打 开 一 个 命令 提示 窗口 ， 
在 命令 提示 符 下 执行 javac -version。 如 果 安 装 成 功 ， 就 会 看 到 Oracle JDK 版 本 号 ， 如 
图 1-8 所 示 。 


C:\windows\aystom3Z\cmd exe 


3\》javac -crsion 
avac 1.6.9_33 


NY 


图 1-8 Oracle JDK 安装 的 有 效 性 验证 


1.1.2 在 Windows 平台 上 下 载 并 安装 Apache ANT 


Apache ANT 是 命令 行 构建 工具 ， 其 任务 是 驱动 根据 目标 和 任务 所 描述 的 任何 类 型 过 
程 。Android 开发 工具 要 求 安装 Apache ANT 1.8 及 以 后 版 本 ， 在 本 书 编写 时 ， 最 新 版 本 是 
Apache ANT 1.8.4。 

请 访问 http://ant.apache.org/bindownload.cgi 网 站 下 载 Apache ANT, 下 载 安装 包 为 ZIP 
格式 ， 如 图 1-9 所 示 。 安 装 步骤 如 下 : 


ED | 


Currently, Apache ant 1.8&.4 is the best avaltable version, see the elaase notes. 


Current Release of Ant 


ote 
Art 1.8.4 was raisesed on 29 Mar- 2012 and may not be avalable on ll mirrers for 3 fen devs, 


[ar thes may roare gm ar to extract 
Tar fles In the dietrinion comtain iang fle names, and may requlre gmu Har to do the extraction, 


1-9 ”ZIP 格式 的 Apache ANT 下 载 安 装 包 


(1) Windows 操作 系统 支持 ZIP 文件 ， 当 下 载 完成 时 右 击 该 ZIP 文件 。 

(2) 在 上 下 文 菜单 中 选择 Extract All 打开 Extract Compressed Folder 向 导 。 

(3) 单 击 Browse 按钮 ， 选 择 目 标 目录 ， 如 图 1-10 所 示 。 因 为 ZIP 文件 已 经 包含 一 个 
名 为 apache-ant-1.8.4 的 目录 用 来 保存 Apache ANT 文件 ， 因 此 不 需要 建立 专用 的 空白 目标 
目录 。 本 书 中 Ci:\android 目录 是 用 来 保存 Android 开发 工具 及 其 相关 工具 的 根 目录 ， 要 记 
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住 目标 目录 名 以 备 后 面 设 置 环境 变量 时 使 用 。 
图 Exroct Comprcsscd (Zipped) Foldcrs 
© Bh Eama Compressed Tioped) Foiders 


Saledt a Destination and Edrac Rles 


EE wl be raved to this folder 
Chandroid| 


回 Show etracted files when complete 


图 1-10 解压 缩 Apache ANT ZIP 文 档 


(4) 单 击 Extract 按钮 安装 Apache ANT。 

Apache ANT 安装 完成 后 ， 按 以 下 步骤 将 其 二 进 制 路 径 追 加 到 系统 可 执行 文件 搜索 路 
径 中 : 

(1) 在 System Properties 界面 打开 Environment Variables 对 话 框 。 

(2) 在 系统 变量 部 分 单 击 New 按钮 定义 一 个 新 的 环境 变量 。 

(3) 将 变量 名 设置 成 ANT_HOME ， 变 量 值 设 置 成 前 面 记 下 的 Apache ANT 安装 目录 
(例如 Ci\android\apache-ant-1.8.4)， 如 图 1-11 所 示 。 


New System Variable 


图 1-11 新 建 ANT_HOME 环境 变量 


(4) 单 击 OK 按钮 保存 新 的 环境 变量 。 
(5) 在 系统 变量 列表 中 , 双击 PATH 变量 , 将 ;% ANT_HOME%\bin 追加 到 变量 值 后 面 ， 
如 图 1-12 所 示 。 


Edit System Variable E3 


Variable name: Path 


图 1-12 将 Apache ANT 二 进 制 路 径 追 加 到 系统 PATH 变量 中 
安装 完成 后 ，Apache ANT 被 添加 到 系统 可 执行 文件 搜索 路 径 中 。 为 了 验证 安装 是 否 
成 功 ， 打 开 一 个 命令 提示 窗口 。 在 命令 提示 符 下 执行 ant -version。 如 果 安 装 成 功 ， 就 会 看 
到 Apache ANT 版 本 号 ， 如 图 1-13 所 示 。 
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FJC-vndowsveystem32vcmd exe 


:Nont 属 crsion 
Apache hntcTMH> version 1.8.4 conpiled on May 22 2812 


SA 可 


1-13 ”Apache ANT 安装 的 有 效 性 验证 


1.1.3 在 Windows 平台 上 下 载 并 安装 Android SDK 


Android 软件 开发 包 (SDK) 是 开发 工具 链 的 核心 组 件 , 它 提供 框架 API 库 和 构建 、 测 试 
及 调试 Android 应 用 所 需要 的 开发 人 员工 具 。 

访问 http://developer.android.com/sdk/index.html 网 站 下 载 Android SDK。 本 书 编写 时 ， 
Android SDK 的 最 新 版 本 是 R20。 当 前 提供 两 种 类 型 的 安装 包 : 图 形 安装 程序 和 ZIP 文档 。 
尽管 图 形 安装 程序 被 认为 是 主要 的 安装 包 ， 但 是 众所周知 ， 在 某 些 平台 上 它 还 存在 问题 。 
单 击 链接 Other platforms 并 下 载 Android SDK ZIP 文档 ， 如 图 1-14 所 示 。 然 后 按照 以 下 步 


:半生 坦 
又 进行 操作 : 
© Fp/ md com are em 5H) 6 ls x pr | 
Developer Tools 人 Get the Android SDK 
Download 
The Android SDK provides you the AP| libraries and 
Inetalling the developer tools necessary to byild est and debug 
本 appe for Androld 
Exploring the SOK 
< [eee ron] 
wor 人 = 一 -一 
Tools Help 
Revtslons 
Etras 
Platform Packag Size MD5 Checksum 
Samples Wadons (CT > 90353014 b62b0f801559c0ac670e94058a21fDdf 
ADK 
nstale!_/20-wndows exe 70497095 0f25321554e2f83b247320d6a3bc1a78 
bytes 


图 1-14 Android SDK 下 载 页 


(6) 下 载 完成 后 ， 右 击 ZIP 文件 , 在 上 下 文 菜单 中 选择 Extract All 打开 Extract Compressed 
Folder 向 导 。 

(7) 单 击 Browse 按钮 , 选择 目标 目录 。 因为 ZIP 文件 中 已 经 包含 一 个 名 为 android-sdk- 
windows 的 子 目录 , 且 其 中 包含 Android SDK 文件 , 因此 不 需要 创建 专用 的 空白 目标 目录 。 
要 记 住 目标 目录 名 以 备 后 面 设置 环境 变量 时 使 用 。 

(8) 单 击 Extract 按钮 安装 Android SDK。 

安装 完成 后 ， 按 以 下 步骤 将 Android SDK 的 二 进 制 路 径 追 加 到 系统 可 执行 文件 搜索 路 
径 中 。 

(1) 在 System Properties 界面 打开 Environment Variables 对 话 框 。 

(2) 在 系统 变量 部 分 单 击 New 按钮 定义 一 个 新 的 环境 变量 。 
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G) 将 变量 名 设置 成 ANDROID_SDK_HOME ,将 变量 值 设置 成 前 面 记 下 的 Android SDK 
安装 目录 (例如 C:\android\android-sdk-windows)， 如 图 1-15 所 示 。 


New System Variable Ix| 
Variable name: ANDROID_SDK_ HOME 


naesue [Coodpnaogsacmraoml | 
Le [sal] 


图 1-15 ANDROID SDK_ HOME 环境 变量 


(4) 单 击 OK 按钮 保存 新 的 环境 变量 。 

(5) 有 三 个 重要 的 目录 需要 添加 到 系统 可 执行 搜索 路 径 中 : SDK 根 目录 、 保 存 Android 
平台 独立 SDK 工 具 的 工具 目录 和 保存 Android 的 平台 工具 目录 ， 不 考虑 不 存在 平台 工具 目 
录 的 情况 。 在 Environment Variables 对 话 框 中 的 系统 变量 列表 中 ， 双 击 PATH 变 量 并 将 
:%ANDROID SDK HOME®%: %ANDROID SDK HOME®%\tools: %ANDROID SDK HOME%\ 
platform-tools 追 加 到 变量 值 后 面 ， 如 图 1-16 所 示 。 


Edit System Variable Ix| 


Variable name: Path | 


[ee 
1-16 将 Android SDK 二 进 制 路 径 追 加 到 系统 PATH 变量 中 
为 了 验证 安装 是 否 成 功 ， 打 开 一 个 命令 提示 窗口 ， 在 命令 提示 符 下 执行 'SDK 
Manager( 命 令 中 包括 引号 )。 如 果 安 装 成 功 ， 就 会 看 到 Android SDK Manager 管理 器 ， 如 
图 1-17 所 示 。 


Padagee Toole 
SDK Path: CNandroid\android sdk-windows 


1-17 Android SDK Manager 应 用 


1.1.4 在 Windows 平台 上 下 载 并 安装 Cygwin 


Android 原 生 开发 包工 具 (Android Native Development Kit,，NDK) 最 初 设计 在 类 UNIX 系 
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统 上 工作 ，NDK 的 一 些 组 件 是 shell 脚 本 ， 这 些 脚 本 不 能 直接 在 Windows 操 作 系统 上 执行 。 

尽管 Android NDK 的 最 新 版 本 表明 它 在 独立 性 和 自我 打包 方面 有 进步 ， 但 是 它 仍然 需要 在 
主机 上 安装 Cygwin 才 能 进行 完整 的 操作 。Cygwin 是 一 个 Windows 操 作 系 统 上 的 类 UNIX 环 
境 和 命令 行 接口 , 它 是 基于 UNIX 应 用 程序 的 , 包括 允许 运行 Android NDK 构 建 系统 的 shell。 
在 本 书 编写 时 , Android NDK 要 求 安装 Cygwin 1.7 才能 运行 。 访问 http://cygwin.comyinstall.html 
网 站 并 下 载 Cyewin 安 装 程序 setup. exe( 如 图 1-18 所 示 )。 


和 crown natantion - W 


下 已- [= 5 Bs x El| 


Cygwin mn 
Install Cygwin 
Ex Cygwin 
Search Packages 
Licensing Terms 

CygwinX Ger thart Linies feeling - on Windows/ 

Community 
Reporting Problems 站 
Installing and Updating Cygwin 
Gold Star 
Miror shes setup exe a time you want to update or install a Cygwin package. The signature for setup exe can be 
Donations toersre validity of this binary using this public key 


图 1-18 下 载 Cygwin 安装 程序 


启动 安装 程序 之 后 ， 可 以 看 见 Cygwin 安装 向 导 欢迎 界面 ， 单 击 Next 按钮 按照 以 下 步 
又 完成 安装 操作 : 
(1) 安装 程序 会 让 用 户 选择 下 载 源 ， 选 择 默认 选项 Install from Intemet， 并 单 击 Next 
(2) 在 下 一 个 对 话 框 中 ， 安 装 程序 会 让 用 户 选择 Cygwin 的 安装 目录 ， 如 图 1-19 所 示 。 
默认 情况 下 ，Cygwin 被 安装 在 C:\cygwin 目录 下 。 注 意 要 记 住 目标 目录 名 以 备 后 面 使 用 ， 
然后 单 击 Next [按钮 。 
[= Cygwin Setup - Ch lation Directory 


Select Root Install Directory 
Select the directory where you want to instal Cygwin. Also choose a few 
instalation parameters 


(ES 


© A Users (RECOMMENDED) 
Cygwin wil be avallable to al users of the system, 


O Just Me 


人 Ony select this 
yo lock daltonor ANIAGSe or VOU HVS pecRo eds 


[ems Ls |] [Low] 


图 1-19 选择 Cygwin 安装 目录 
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(3) 下 一 个 对 话 框 将 让 用 户 选择 原生 包 目 录 ， 这 是 一 个 用 于 下 载 文件 包 的 临时 目录 。 
使 用 默认 值 ， 然 后 单 击 Next 按钮 。 

(4) 下 一 个 对 话 框 将 让 用 户 选择 Internet 连接 类 型 ， 除 非 需要 用 代理 访问 Intemet， 否 
则 选择 默认 项 Direct Connection， 然 后 单 击 Next 按钮 继续 。 

(5) 安装 程序 将 让 用 户 选择 下 载 站 点 ， 从 镜像 站 点 列表 中 随机 选择 一 个 站 点 或 者 选择 
一 个 离 安 装 站 点 地 理 位 置 最 近 的 站 点 ， 然 后 单 击 Next 按钮 。 

(6) Cygwin 不 是 单个 的 应 用 程序 ， 是 包含 多 个 应 用 程序 的 巨大 的 软件 分 布 。 在 下 一 个 
对 话 框 中 ，Cygwin 安装 程序 会 为 用 户 提供 一 个 可 用 包 列 表 ，Android NDK 要 求 安装 GNU 
Make 3.8.1 及 以 后 版 本 以 正常 使 用 其 功能 。 在 搜索 框 中 输入 关键 字 make 对 包 列 表 进 行 过 
滤 ， 展 开 Devel 目录 ， 选 择 GNU Make 包 ， 如 图 1-20 所 示 。 单 击 Next 按钮 开始 安装 。 

安装 完成 后 ， 要 把 Cygwin 二 进 制 路 径 添加 到 系统 可 执行 搜索 路 径 中 。 

(1) 从 System Properties 打开 Environment Variables 对 话 框 。 

(2) 在 系统 变量 部 分 单 击 New 按钮 定义 一 个 新 的 环境 变量 。 

(3) 将 变量 名 设置 成 CYGWIN HOME, 将 变量 值 设置 成 Cygwin 安装 目录 (例如 Ci\cygwin)， 
如 图 1-21 所 示 。 

(4) 在 Environment Variables 对 话 框 中 的 系统 变量 列表 中 双击 PATH 变量 ， 并 将 
;%CYGWIN_HOME%\bin 追加 到 变量 值 后 面 ， 如 图 1-22 所 示 。 


Cygwin Sctup - Sclcct Packogcs 
Seochnakdl [Qeer O keep © oar OEp [Ven | caeyoy 
Cat B..| 5..| Sze Package 图 
Dea 
日 Deval 6 Defaih 
skp Co .automake. Wrapper scnipts for aulomake and aclocal 
kip mm me 714k automaks110: (1.10) a toolforgeneraiing GNU-compliant Mal 
kip Wo mo B46k. automaks111: (1.11) a toolfor generating GNU-compliant Mal 
他 skp mo me 244k automake1 4: (1.4) a toolfor generatng GNUcomplant Maksf| 
人 Skip ne me 328k automake1 5: (1.5)a toolfor generaing GNU-compliant Maksf| 
Skip Ne me 363k automake16: (1.6) 3 toolfor generaing GNU -compliant Makaf 
5kp mm mp 424k automake1 7: (1.7) a toolfor generaing GNU-compliant Makal 
kip mm me 497k automake1 8: (1.8) a toolfor generaing GNU-compliant Maksf| 
人 skp nj me 556k automoke19: (19) atoeolfor generoing GNU-compliant Makeef| 
5kp mh me 6676k cmake: Acoss platom buid manager 
心 Skip ma ne 418k gcctoolsepoch automake: (occ-special) atool for 
Okip 咯咯 57Bk gcctcokcpodh2eutonckc Gccspcdal otodl for 
Skip mm mw Sk gcemakedep: Xorg preprocessor dependency maker 
: 口 442k make The GNU vesion of he makc'uliiy 
Sr 人 zx_aaksdspscd_yxo ef er Ec tool 下 
CC | 中 


图 1-20 选择 GNU Make 包 
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New System Variable [x| 


Variable name: [ CYGWIN_HOME 
Variable value: [ceowr | 


WE | | 


图 1-21 CYGWIN_HOME 环境 变量 


Variable name: Path 
Variable value: [ :%\platform-tools; %CYGWIN_HOME %\bir| 
Ce [Loe |] 


图 1-22 将 Cygwin 二 进 制 路 径 追加 到 系统 PATH 变量 中 


完成 了 上 述 安 装 步骤 后 ，Cygwin 工具 成 为 系统 可 执行 搜索 路 径 的 一 部 分 。 为 了 验证 安 
装 是 否 成 功 , 打开 一 个 命令 提示 窗口 , 在 命令 提示 符 下 执行 make -version。 如 果 安 装 成 功 ， 
则 会 显示 GNU Make 的 版 本 号 ， 如 图 1-23 所 示 。 


加 C:\windows\system32\cmd exe 


:N?make ~version 

NU Make 3.82.9@ 

uilt for i686. 2 二 

opyright <C> 2819 ree Software Foundation, Inc- 


License GPLv3+: GNU Ee er 3 人 Laer <http://gnu. ds TA 
his is free software: re free change and EO bute it. 
here is NO WARRANTY, 记 这 extent a by lav 


B34 


图 1-23 验证 Cygwin 安装 结果 
1.1.5 在 Windows 平台 上 下 载 并 安装 Android NDK 


Android 原生 开发 工具 包 (Native Development Kit，NDK) 是 Android SDK(Software 
Development Kit) 的 伴随 工具 ， 它 可 以 让 用 户 用 诸如 C++ 的 原生 编程 语言 开发 Android 应 用 
程序 。Android NDK 提供 了 头 文件 、 库 和 交叉 编译 器 工具 链 。 本 书 编写 时 ，Android NDK 
的 最 新 版 本 是 R8。 请 定位 到 http://developer.android.com/tools/sdk/ndk/index.html 网 站 并 找 
到 图 1-24 所 示 的 Downloads 部 分 。 下 载 步骤 如 下 : 
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wd Developers - Windows rter 


[Emcor NOK an pev Windows temet Explorer 
OO Fr /ep med comnoo /sam rae eliDomrionts 5 可 日 + X WR 


Packag Se | MDS Checksum 


109928336 37b1a2576f28752fcc09e1b9c07e3f14 
bytes 


MacOSX (nte | android-ndk-r8-darwin- 96650992 bytes | 81ce5de731f945692123b377afe0bad9 
x86.tar bz2 


Linux 32/64-bit android-ndk-r8-linux- 88310791 bytes | 5c9afc9695ad67c61f82fbf896803c05 
(x86) x86 tar bz2 


图 1-24 Android NDK 下 载 页 面 


(1) Android NDK 安装 包 以 ZIP 文档 的 形式 提供 。 下 载 完成 时 , 右 击 ZIP 文件 并 在 上 下 
文 菜单 中 选择 Extract All 选项 ， 打 开 Extract Compressed Folder 向 导 。 

(2) 用 Browse 按钮 选择 目标 目录 。 因 为 ZIP 文件 中 已 经 包含 一 个 名 为 android-ndk-r8 
的 子 目录 ， 其 中 包含 Android NDK 文件 ， 因 此 不 需要 建立 专用 的 空白 目标 目录 。 要 记 住 目 
标 目录 名 以 备 后 面 设置 环境 变量 时 使 用 。 

(3) 单 击 Extract 按钮 安装 Android NDK。 

安装 完成 后 , 按 以 下 步骤 将 Android SDK 的 二 进 制 路 径 追 加 到 系统 可 执行 搜索 路 径 中 ， 

(1) 同样 ， 在 System Properties 界面 打开 Environment Variables 对 话 框 。 

(2) 在 系统 变量 部 分 单 击 New 按钮 定义 一 个 新 的 环境 变量 ， 将 变量 名 设置 成 ANDROID_ 
NDK_HOME, 将 变量 值 设置 成 前 面 记 下 的 Android NDK 安装 目录 (例如 C:\android\android- 
ndk-r8)， 如 图 1-25 所 示 。 


Variable name: [ANDROID_NDK_HOME 
Variable value: [ C:\android\android-ndk-r8| 
1-25 ” ANDROID_NDK_HOME 环境 变量 


(3) 单 击 OK 按钮 保存 该 新 环境 变量 。 
(4) 在 环境 变量 对 话 框 中 的 系统 变量 列表 中 ， 双 击 PATH 变量 ， 并 将 ;%ANDROID_ 
NDK_HOME% 追 加 到 变量 值 后 面 ， 如 图 1-26 所 示 。 


Variable name: Path _ 
Variable value: N_HOME%%\bin; %ANDROID_NDK_HOME% 


图 1-26 将 Android NDK 二 进 制 路 径 追 加 到 系统 PATH 变量 中 
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现在 可 以 很 容易 地 访问 Android NDK。 为 了 验证 安装 是 否 成 功 ， 打 开 一 个 命令 提示 窗 
口 ， 在 命令 提示 符 下 执行 ndk-build。 如 果 安 装 成 功 ， 就 会 看 到 NDK 给 出 的 关于 项 目 目录 
的 提示 ， 如 图 1-27 所 示 。 


EY C:\windows\system32\cmd exe 


:\ ndk-build 
IAndroid NDK: Could not find Rn To directory + 
ete NDK: Please define the NDK_P TH i to point to it 
Nandroid\android-ndk-—r8\bu: ean edn mk:130: xxx Android NDK: Aborti 
Ihg 9 


:\)- 


图 1-27 Android NDK 安装 结果 验证 
1.1.6 在 Windows 平台 上 下 载 并 安装 Eclipse 


Eclipse 是 高 度 可 扩展 的 、 多 语言 集成 的 开发 环境 ， 尽 管 原生 Android 开发 不 要 求 必须 
安装 Eclipse， 但 是 因为 Eclipse 提供 了 高 度 集成 的 编码 环境 ,将 其 与 Android 工具 结合 使 
用 可 以 简化 应 用 程序 的 开发 过 程 。 本 书 编写 时 ，Eclipse 的 最 新 版 本 是 Juno 4.2， 请 访问 
http://www.eclipse.org/downloads/ 网 站 下 载 Eclipse， 如 图 1-28 所 示 ， 下 载 步骤 如 下 : 


5D8 4 x 硬 ERERE x| 

Eclpse Juno (4.2) Packages [wsos 7] Installing Eclipse 
Eclipse IDE for Java EE Developers 221we Windows32BR InstalGulde 
po Tes Dette Windows 64B = » ComparelCombine Packages 
«Known Issues 


= Eclipse Classic 4.2 182 MB Windows 32 Bit 
Downioaded 108.439 Times OD Other Downloaas Windows 64 Bit 


Ce Eclipse IDE for Java Developers 149 MB Windows 32 BIt SAMPLE CODE FOR 
Downloaded 56.133 Times Details Windows 64 Bit BUI RE 


Yeas 一 
图 1-28 ”Eclipse 下 载 页 面 


(1) 从 列表 中 下 载 Eclipse Classic for Windows 32 Bit，Eclipse 安装 包 以 ZIP 文档 形式 
提供 。 

(2) 下 载 完 成 时 , 右 击 该 ZIP 文件 ,并 在 上 下 文 菜单 中 选择 Extract All 选项 ,打开 Extract 
Compressed Folder 向 导 。 

(3) 用 Browse 按钮 选择 目标 目录 ， 因 为 ZIP 文件 中 已 经 包含 一 个 名 为 eclipse 的 子 目 
录 ， 其 中 包含 Eclipse 文件 ， 因 此 不 需要 建立 专用 的 空白 目标 目录 。 要 记 住 目 标 目录 名 以 备 
后 面 设 置 环境 变量 时 使 用 。 

(4) 单 击 Extract 按钮 安装 Eclipse。 

(5) 为 了 方便 访问 Eclipse， 进 入 Eclipse 安装 目录 。 

(6) 右 击 Eclipse 二 进 制 ， 并 选择 Send | Desktop 在 Windows 桌面 上 建立 Eclipse 的 快 
捷 键 。 

为 了 验证 Eclipse 安装 结果 的 有 效 性 , 双击 Eclipse 图 标 。 如果 安装 成 功 , 将 看 到 图 1-29 
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所 示 的 Eclipse Workspace Launcher 对 话 框 。 


Workapace Launcher x) 


Select 2 workspace 


Eclipse SDK stores your projects in a folder called a workapace. 
Choose a workspace folder to use for this eession. 


Workspace: |C\android\workspace | Browse 


OD Use thts as the diefault and do not ask again 


mT | ce |] 


图 1-29 Eclipse 安装 结果 验证 


1.2 Apple Mac OS X 


Android 开发 工具 要 求 Mac OS X 10.5.8 及 后 续 版 本 和 x86 系统 。 因 为 Android 开发 工 
具 最 初 被 设计 成 在 类 UNIX 操作 系统 上 工作 ， 可 以 直接 通过 OS X 或 者 Xcode 开发 工具 在 
平台 上 使 用 它 的 大 多 数 扩展 功能 。 在 本 节 中 ， 用 户 需 要 下 载 并 安装 以 下 组 件 : 
® Xcode 
Java JDK 6 
Apache ANT Build System 
GNU Make 
Android SDK 
Android NDK 
Eclipse IDE 


1.2.1 在 Mac 平台 上 安装 Xcode 


Xcode 可 以 为 O0S 和 平台 上 的 应 用 程序 开发 提供 开发 工具 。 它 可 以 在 Mac OS X 安装 介 
质 中 找到 ， 或 者 通过 Mac App Store 免费 获取 。 访 问 https://developer.apple.comy/xcode/ 网 站 
可 以 获取 更 多 信息 。 启 动 Xcode 安装 程序 将 进入 Xcode 安装 向 导 ， 向 导 程 序 将 引导 你 完成 
安装 过 程 。 

(1) 同意 许可 协议 。 

(2) 选择 目标 目录 。 

(3) 安装 向 导 会 显示 可 以 安装 的 Xcode 组 件 列表 ， 从 列表 中 选择 UNIX 开发 工具 包 ， 
如 图 1-30 所 示 。 

(4) 单 击 Continue 按钮 开始 安装 。 
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Optional content to allow command-line development from the 
boot volume. Installs a duplicate of the GCC compiler and 
command line tools included with the core Xcode developer tools 
package into the boot volume. It also installs header files, 
libraries, and other resources for developing software using Mac 了 


人 


图 1-30 Xcode 定制 安装 程序 对 话 框 


1.2.2 ”验证 Mac 平台 的 Java 开发 包 


Android 开发 工具 要 求 事先 安装 JDK(Java Development Kit)6 才能 运行 ,苹果 Mac OS X 
操作 系统 已 经 配置 了 JDK， 所 配置 的 JDK 是 基于 Oracle JDK 的 ， 但 是 由 苹果 来 配置 DK 
可 以 更 好 地 与 Mac OS X 集成 。 可 以 通过 Software Update 获取 JDK 的 新 版 本 。 必 须 确 保安 
装 的 是 JDK 6 及 以 后 版 本 。 为 了 验证 JDK 的 安装 效果 ,打开 一 个 终端 窗口 ， 在 命令 行 方式 
下 执行 javac -version。 如 果 JDK 安装 正确 ， 会 看 到 JDK 的 版 本 号 ， 如 图 1-31 所 示 。 

BO Terminal 一 bash 一 80x6 


$ javac -version 
javac 1.6.9_33 
0 


图 1-31 验证 JDK 
1.2.3 验证 Mac 平台 上 的 Apache ANT 


Apache ANT 是 命令 行 构建 工具 , 它 可 以 驱动 任何 根据 目标 和 任务 描述 的 过 程 , Android 
开发 工具 要 求 安装 Apache ANT 1.8 及 以 后 版 本 才能 运行 构建 过 程 ,Apache ANT 作为 Xcode 
的 UNIX 开发 包 的 一 部 分 安装 到 系统 中 。 为 了 验证 Apache ANT 的 安装 效果 ， 打 开 一 个 终 
端 窗口 并 在 命令 行 方式 下 执行 ant -version。 如 果 安 装 成 功 , 会 看 到 Apache ANT 的 版 本 号 ， 
如 图 1-32 所 示 。 
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(SRSRS) Terminal — bash — 80x5 

$ ant -version BE 
Sn Ant(TM) version 1.8.2 compiled on May 17 2012 

$$ 


1-32 验证 Apache ANT 


1.2.4 ”验证 GNU Make 


GNU Make 是 在 应 用 程序 源 代码 中 控制 生成 程序 中 的 可 执行 程序 部 分 及 其 他 部 分 的 构 
建 工具 。Android NDK 要 求 安 装 GNU Make 3.8.1 及 以 后 版 本 。GNU Make 是 作为 Xcode 
的 UNIX 开发 包 的 一 部 分 安装 到 系统 中 。 为 了 验证 GNU Make 的 安装 效果 ， 打 开 一 个 终端 
窗口 ， 在 命令 行 方式 下 执行 make -version。 如 果 安 装 成 功 ， 会 看 到 GNU Make 的 版 本 号 ， 
如 图 1-33 所 示 。 


QON Terminal 一 bash 一 80x10 


$ nake -version 

CNU Make 3.81 

Copyrignt (Cc) 2996 Free Software Foundation, Inc. 

This is free software; see the source for copying conditions. 

There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A 
PARTICULAR PURPOSE. 


i program built for i386-apple-darwin10.0 
$ 


图 1-33 验证 GNU Make 
1.2.5 ”在 Mac 平台 上 下 载 并 安装 Android SDK 


Android 软件 开发 包 (SDK) 是 开发 工具 链 的 核心 组 件 ， 它 提供 了 构建 、 测 试 和 调试 
Android 应 用 程序 所 需要 的 框架 API 库 和 开发 工具 。 本 书 编写 时 ，Android SDK 的 最 新 版 
本 是 R20， 请 访问 http://developer.android.com/sdk/index.html 网 站 下 载 Android SDK， 如 
图 1-34 所 示 。 安 装 步骤 如 下 : 

[TIa] Androld SDK | Andrend Developers 


aj» Nef [ghtto:/ developer.androd com/sdk nncen neml © | {A Androd NOK 
| android spw Android Developers 


Developer Tools Get the Android SDK 
Download 
The Android SDK provides you the APIlibraries and 


am the developer tools necessary io build, test and debug 


Exploring IneSDK 
NOK 


Workflow 
Tools Help 


Revisions 


图 1-34 Android SDK 下 载 页 面 
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第 1 章 Android 平台 上 的 C++ 入 门 


(1) 单 击 Download the SDK for Mac 按钮 开始 下 载 SDK 安装 包 。 

(2) Android SDK 安装 包 以 ZIP 文档 方式 提供 ，OS XX 提供 对 ZIP 文档 的 原生 支持 。 如 
果 使 用 Safari 浏览 器 ， 则 ZIP 文件 会 在 下 载 后 自动 解压 ， 也 可 以 双击 下 载 的 ZIP 文件 以 压 
缩 文件 夹 的 形式 打开 文件 。 

(3) 使 用 Finder 将 android-sdk-macosx 目录 拖 放 到 目标 文件 夹 下 ， 如 图 1-35 所 示 。 本 
书 中 /android 目录 是 保存 Android 开发 工具 及 其 相关 组 件 的 根 目录 。 


[eee 站 android SS 
EI :: 四 Wl nl arm [© |g- > 
WDEVICES { 

司 Macintosh HD 
Eipisk 


189 57 CR zavailabhie 。 CD 189.57 CB available eC 


图 135 将 Android SDK 安装 到 目标 位 置 


为 了 便于 访问 Android SDK， 要 把 Android SDK 二 进 制 路 径 追 加 到 系统 可 执行 搜索 路 
径 中 。 打 开 一 个 终端 窗口 并 执行 下 列 命令 ， 如 图 1-36 所 示 : 


Terminal — bash — 110x6 
$ echo export MNDROID_SDK_HOME=/android/android-sdk-macosx ss */.bash profile 


a 
§ 有 expart PATH=\SANDROID SDK_HOME/tools:\SANDROID_SDK_HOME/plattorm-tools:\SPATH >> ~/.bash_profile 0 


图 1-36 将 SDK 二 进 制 路 径 追 加 到 系统 PATH 变量 中 


® echo export ANDROID SDK HOME=/android/android-sdk-macosx > > 
~/.bash profile 
® echo export PATH = \$SANDROID SDK HOME/tools:\$ANDROID SDK HOME/ 
platformtools:\$PATH > > ~/.bash profile 
为 了 验证 Android SDK 的 安装 效果 ， 打 开 一 个 新 的 终端 窗口 并 在 命令 行 方式 下 执行 
android -h。 如 果 安 装 成 功 ， 将 会 看 到 图 1-37 显示 的 帮助 信息 。 


OO Terminal 一 bash 一 80x6 
车 android -h 目 
Usage: 
android [global options] action laction options] 站 
Global options: 加 
-~h 一 hetLp : Help on a specific command . 


1-37 验证 Android SDK 安装 效果 
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Android C++ 高 级 编程 一 一 使 用 NDK 


1.2.6 在 Mac 平台 上 下 载 并 安装 Android NDK 


Android 原生 开发 工具 包 (NDK) 是 Android SDK 的 伴随 工具 , 它 可 以 让 用 户 用 诸如 C++ 
之 类 的 原生 编程 语言 开发 Android 应 用 程序 。Android NDK 提供 头 文件 、 库 和 交叉 编译 器 
工具 链 。 本 书 编写 时 ，Android NDK 的 最 新 版 本 是 R8。 请 到 http://developer.android.com 
/tools/sdk/ndk/index.html 网 站 下 载 Android NDK， 下 载 部 分 如 图 1-38 所 示 。 下 载 步骤 如 下 : 


ee Anarold NOK | Androld Developers 
Al [ef [二 Bhrto:! /developer androd comjtoals/sdkrndu ndex himizDownloacs Ee ¢ | [Q- Androd NOK g@) 
re nde Ooo pe 
i Downloads a 
Exploring the SDK | 
Platform Sia MDS Checksum 
WOK 
Windows android-ndhk-rB-windows 2ip 109928336 37b1a2576128752fcc09ge1b9c0Te3f14 
Workdlow v byes 
MacOSX mel) (android-ndh-r-darwin- 96650992 81ce5de7311945692123b377afeabad9 
Tools Help X86 Tar bz2 bytes ] 
Rewlstons ~ Lnux 32/64-blt an Tr 88310791 5c9afc95958d67c61f82fof896803c05 | 
(x86) X06 18r bz2 bmes 
Extras | 
Samples Revisions 此 


图 1-38 AndroidNDK 下 载 页 面 


(1) 单 击 下 载 安装 包 , Android NDK 安装 包 以 BZIP’ed TAR 文档 形式 提供 , OS X 不 会 
自动 解压 这 种 类 型 的 文件 。 

(2) 为 了 自动 解压 文件 ， 打 开 一 个 终端 窗口 。 

(3) 进入 目标 目录 /android。 

(4) 执行 tar jxvf “/Downloads/android-ndk-r8-darwin-x86.tar.bz2， 如 图 1-39 所 示 。 


Qo Terminal — bash — 80x6 


cd /android 
tar jxvf ~/Downloads/ondroid-ndk-r8-darwin-x86,. tar. bz2 


android-ndk-r8/prebuilt/ 
android-ndk-r8/prebuilt/darwin-x86/ 
android-ndk-r8/prebuilt/darwin-x86/bin/ 


1-39 安装 Android NDK 


为 了 便于 访问 , 要 把 Android NDK 二 进 制 路 径 追 加 到 系统 可 执行 搜索 路 径 中 ,打开 终 
端 窗口 并 执行 下 列 命 令 (如 图 1-40 所 示 )。 


$$ 
$ 
x android-ndk-r8/ 
x 
x 
x 


个 日 日 Terminal 一 bash 一 80x6 

$ echo export ANDROID_NDK_HOME=/android/jandroid-ndk-r8 >> ~/.bash_profile 加 
$ echo cxport PATH=\$ANDROID_NDK_HOME:\$PATH >> ~/,bash_profile 

$0 b 


1-40 将 Android NDK 二 进 制 路 径 追 加 到 系统 PATH 变量 中 
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® echo export ANDROID NDK HOME=/android/android-ndk-r8 > > 
~/-.bash profile 加 
® echo export PATH = \$ANDROID NDK HOME:\SPRTH > > ~/.bash profile 
打开 一 个 新 的 终端 窗口 并 在 命令 行 方式 下 执行 命令 ndk-build 以 验证 Android NDK 的 
安装 效果 。 如 果 安 装 成 功 ， 就 会 看 到 NDK 给 出 的 关于 项 目 目录 的 提示 ， 如 图 1-41 所 示 。 


AOo Terminal — bash — 80x6 


$$ ndk-build 

Android NDK: Could not find opplicotion project dircctory ! 

Android NDK: Please define the NDK_PROJECT_PATH variable to point to it. 

/android/android-ndk-r8/build/core/build-local.mk:138: *** Android NDK: Aborting 全 
Stop. F 


$ 


1-41 验证 Android NDK 


1.2.7 在 Mac 平台 上 下 载 并 安装 Eclipse 


Eclipse 是 高 度 可 扩展 的 、 多 语言 集成 开发 环境 ， 尽 管 原生 Android 开发 不 要 求 必须 
安装 Eclipse， 但 是 Eclipse 提供 了 高 度 集成 的 编码 环境 ， 它 与 Android 工具 结合 使 用 可 
以 简化 应 用 程序 的 开发 过 程 。 本 书 编写 时 ，Eclipse 的 最 新 版 本 是 Juno 4.2。 请 访问 
http://www.eclipse.org/downloads/ 网 站 下 载 Eclipse， 如 图 1-42 所 示 ， 下 载 步骤 如 下 : 


Mac OS X32 EN 
Mac OS X64 BK 


Mac OS X32 ER 
Msc OS XE4 BN 


fa ] Eclipse IDE for Java Developers 148V5 Mac OSX 32 BE 
Doewte 


Pereaaed $4.71¢ Tre Mec OS XE4 BI 


图 1-42 ”Eclipse 下 载 页 面 


(1) 从 列表 中 下 载 Eclipse Classic for Mac OS X 32 Bit。Eclipse 安装 包 以 GZIP'ed TAR 
形式 提供 ， 如果 使 用 Safari 浏览 器 ， 文 件 会 自动 解压 ， 但 是 下 载 后 不 会 自动 提取 。 

(2) 为 了 手动 释放 文件 ， 打 开 一 个 终端 窗口 并 进入 /android 的 目标 目录 。 

(3) 执行 tar xvf “/Downloads/eclipse-SDK-4.2-macosx-cocoa.tar， 如 图 1-43 所 示 。 


Qe9 


cd /android 

tar xvf ~/Downloads/cclipse-SDK-4.2-macosx-cocon, tar 
eclipse/ 

eclipse/Eclipse.app/ 

eclipse/Eclipse.app/Contents/ 
eclipse/Eclipse.app/Contents/Info. plist 


1-43 ”安装 Eclipse 


Terminal 一 bash 一 80x6 


Xxx 二 坊 


到 有 
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为 了 便于 访问 Eclipse， 可 以 按照 如 下 步骤 将 Eclipse 添加 到 dock 中 : 
(1) 进入 Eclipse 安装 目录 。 
(2) 将 Eclipse 应 用 程序 拖 放 到 Dock 中 ， 如 图 1-44 所 示 。 


1-44 将 Eclipse 加 入 停靠 栏 


为 了 验证 Eclipse 安装 结果 的 有 效 性 ， 双 击 Eclipse 图 标 。 如 果 安 装 成 功 ， 你 就 会 看 到 
图 1-45 所 示 的 Eclipse Workspace Launcher 对 话 框 。 
.800 Workspace Launcher 
Select a workspace 


Eclipse SDK stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


Workspace: | Jandrold/workspace [*} Browse... ) 


口 Use this as the default and do nct ask again 


图 1-45 验证 Eclipse 


1.3 Ubuntu Linux 


Android 开发 工具 要 求 安装 Ubuntu Linux 8.04 32-bit 以 及 后 续 版 本 或 者 安装 支持 GNU 
C Library(glibe)2.7 及 以 后 版 本 的 其 他 Linux。 在 本 节 中 用 户 需 要 下 载 并 安装 以 下 组 件 : 

® JavaJDK6 
® Apache ANT Build System 
® GNU Make 
® Android SDK 
e Android NDK 
e Eclipse IDE 


1.3.1 检查 GNU C 库 版 本 


可 以 通过 在 终端 窗口 中 运行 ldd --version 来 检查 GNU C 库 版 本 ， 如 图 1-46 所 示 。 


第 1 章 Android 平台 上 的 C++ 入 门 


$ 1Ldd --version 
ldd (Ubuntu EGLIBC 2.15-@ubuntul G2.15 ) 
ICcopyright (C) 2612 Free Software Found bn, Inc. 


This is free software; see the source for copying conditions. There is NO 
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 
二 让 by Roland McGrath and ULrtch Drepper . 

$ 


图 1-46 检查 GNU C 库 版 本 


1.3.2 激活 在 64 位 系统 上 支持 32 位 的 功能 


在 64 位 Linux 发 布 之 后 ，Android 开发 工具 要 求 安装 32 位 支持 包 。 为 了 安装 32 位 支 
持 包 ， 打 开 一 个 终端 窗口 并 执行 sudo apt-get install ia32-libs-multiarch， 如 图 1-47 所 示 。 


$ sudo apt-get install 1a32-1ibs-multiarch 
Reading package 1ists... Done 
Building dependency tree 


Reading state information... Done 

The following extra packages will be installed: 
esound-common gtk2-engines-oxygen gtkz-engtnes-ptxbuf libaiol libao-common 
libao4 libaudiofilel libcapi2z9-3 libesde libgettextpoe Ltbmad6 libmikmodz 
libmpg123-8 libodbc1 libopenal-data libopenall libqt4-designer 


图 1-47 安装 ia32-libs-multiarch 


1.3.3 在 Linux 平台 上 下 载 并 安装 Java 开发 工具 包 (JDK) 


Android 开发 工具 要 求 安装 JDK 6 才能 运行 。 不 能 只 安装 JRE(Java Runtime Edition)， 
在 安装 Android 开发 工具 之 前 需要 先 安装 Java JDK 6。 除 了 针对 Java(gcj)GNU Compiler 以 
外 ，Android 开发 工具 支持 多 种 发 行 版 本 的 JDK， 例 如 IBM JDK、Open JDK 以 及 Oracle 
JDK( 以 前 称 为 Sun JDK)。 由 于 许可 问题 , Oracle JDK 不 能 用 于 Ubuntu 软件 库 。 本 书 以 Open 
JDK 为 例 进 行 讲解 。 为 了 安装 Open JDK， 打 开 一 个 终端 窗口 并 执行 sudo apt-get install 
openjdk-6-jdk， 如 图 1-48 所 示 。 


$ sudo apt-get install openjdk-6-jdk 
Reading package lists... Done 
Butlding dependency tree 
lReading state information... Done 

The following extra packages will be installed: 

icedtea-6-jre-cacao tcedtea-6-jre-jamvm openjdk-6-jre openijdk-6-jre-headless 
openjdk-6-jre-lib 


图 1-48 安装 Open JDK 6 


为 了 验证 Open JDK 安装 结果 的 有 效 性 ， 打 开 一 个 终端 窗口 并 在 命令 行 方 式 下 执行 
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Android C++ 高 级 编程 一 一 使 用 NDK 


java -version。 如 果 安 装 成 功 ， 就 会 看 到 如 图 1-49 所 示 的 Open JDK 版 本 号 。 


5 java -verston 
java version "1.6.6 24" 
penJDK Runttme Environment (IcedTea6 1.11.1) (6bz4-1.11.1-4ubuntuz2) 


Ce Server VM (bulld 26.6-b12, mixed mode) 
5 


图 1-49 验证 Open JDK 的 安装 效果 
1.3.4 在 Linux 平台 上 下 载 并 安装 Apache ANT 


Apache ANT 是 命令 行 构建 工具 ， 可 以 驱动 任何 根据 目标 和 任务 描述 的 过 程 。Android 
开发 工具 要 求 安装 Apache ANT 1.8 及 以 后 版 本 ,Apache ANT 通过 Ubuntu 软件 库 提供 。 为 
了 安装 Apache ANT， 打 开 一 个 终端 窗口 并 执行 sudo apt-get install ant， 如 图 1-50 所 示 。 


clnar@onur-ubuntu 

5 sudo apt-get install ant 

Reading package lists... Done 

Building dependency tree 

Reading state information... Done 

The following extra packages will be installed: 
ant-optional libxerces2-java libxnl-comnons-external-java 
Ubxnl -commons-resolver1.1- java 


1-50 ”安装 Apache ANT 


为 了 验证 Apache ANT 的 安装 效果 ， 打 开 一 个 终端 窗口 并 在 命令 行 方式 下 执行 ant 
-version。 如 果 安 装 成 功 ， 将 会 显示 Apache ANT 的 版 本 号 ， 如 图 1-51 所 示 。 


clnar@onur-ubuntu 


5 ant -verston 


pache Ant version 1.8.6 compiled on February 1 2616 
已 


图 1-51 验证 Apache ANT 安装 效果 
1.3.5 在 Linux 平台 上 下 载 并 安装 GNU Make 


GNU Make 是 一 种 构建 工具 ， 用 于 控制 应 用 程序 源 代码 的 可 执行 代码 和 其 他 部 分 代码 
的 生成 。Android NDK 要 求 安装 GNU Make 3.8.1 及 以 后 版 本 。GNU Make 是 由 Ubuntu 软 


件 库 提 供 的 。 为 了 安装 GNU Make， 打 开 一 个 终端 窗口 并 执行 sudo apt-get install make， 如 
图 1-52 所 示 。 


|$ sudo apt-get ‘nstall make 

|[sudo] password for cinar: 

Reading package lists... Done 

Butlding dependency tree 

Reading state information... Done 

make is already the newest version. 

8 upgraded, © newly installed, © to remove and 225 not upgraded. 


图 1-52 安装 GNU Make 


第 1 章 Android 平台 上 的 C++ 入 门 


为 了 验证 GNU Make 的 安装 效果 ， 打 开 一 个 终端 窗口 并 在 命令 行 方式 下 执行 make -version 。 
如 果 安 装 成 功 ， 将 会 显示 GNU Make 的 版 本 号 ， 如 图 1-53 所 示 。 


5 make -verston 

GNU Make 3.81 

[copyright (C) 2886 Free Software Foundation, Inc. 

This is free software; see the source for copying conditions. 

There 1s NO warranty; not even for MERCHANTABILITY or FITNESS FOR A 
PARTICULAR PURPOSE. 


program built for i686-pc-linux-gnu 
5 


图 1-53 验证 GNU Make 安装 效果 
1.3.6 在 Linux 平台 上 下 载 并 安装 Android SDK 


Android 软件 开发 包 (SDK) 是 开发 工具 链 的 核心 组 件 ， 它 提供 了 构建 、 测 试 和 调试 
Android 应 用 程序 所 需要 的 框架 API 库 和 开发 工具 。 本 书 编写 时 ，Android SDK 的 最 新 版 
本 是 R20， 请 访问 http://developer.android.com/sdk/index.html 网 站 下 载 Android SDK， 如 
图 1-54 所 示 。 安 装 步骤 如 下 : 


TREE 
8 


Be Peckage $i MD5 Checksum 

androd-sck 720-winGowa pp 90353014 b62bOfB04559c0ac670e9f058a21f0df 
Download ~ bytes 
Installing the installes 120-windows exe 70497095 0Df25321554e218Bb247320d6a3bc1373 
SOK (Recommended) bytes 


Exploring the SDK MacOSX android-schi 120-macosx zip 58203018 b6b6035ccec55ec2na057438eb1db1f4 
(ntel) bytes 

Linux (1386) 82589455 22a81cf1d4a951c62f7188758290e9bb 
bytes 


1-54 Android SDK 下 载 页 面 


(1) Android SDK 安装 包 以 GZIP'ed TAR 方式 提供 ， 打开 一 个 终端 窗口 并 进入 目标 日 
录 。 本 书 中 ~/android 目录 是 保存 Android 开发 工具 及 其 相关 组 件 的 根 目录 。 

(2) 在 命令 行 方式 下 执行 tar zxvf >/Downloads/android-sdk IT20-linux.tgz 解压 Android 
SDK， 如 图 1-55 所 示 。 


$ cd ~/android 

S tar zxvf -/Downloads/android-sdk_r28- linux.tgz 
androtd-sdk-Ltnux/ 

androtd-sdk-LLnux/pLatforms/ 
android-sdk-Linux/add-ons/ 
androtd-sdk-Ltnux/SDK Readme.txt 
android-sdk-Linux/tools/ 


1-55 ”安装 Android SDK 
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为 了 便于 访问 Android SDK， 应 该 把 Android SDK 二 进 制 路 径 追 加 到 系统 可 执行 搜索 
路 径 中 。 假 设 使 用 BASH shell， 打开 一 个 终端 窗口 并 执行 下 列 命令 (如 图 1-56 所 示 ): 


5 echo export ANDROID_SDK_HOME=~/androld/androld-sdk-linux >> ~/.bashrc 

$ echo export PATH=\$ANDROID SDK_HOME/tools:\SANDROID SDK_HOME/platform-tools:\S$PATH| 
| >> ~/.bashrc 

$ 


图 1-56 将 SDK 二 进 制 路 径 追 加 到 系统 PATH 变量 中 


® echo export ANDROID SDK HOME = ~/android/android-sdk-linux > > 
~/ .bashrc 
® echo export PATH = \$ANDROID SDK HOME/tools:\$ANDROID SDK HOME/ 
platformtools:\$PATH > > ~/.bashrc 
为 了 验证 Android SDK 的 安装 效果 ， 打 开 一 个 新 的 终端 窗口 并 在 命令 行 方式 下 执行 
android -h。 如 果 安 装 成 功 ， 将 会 看 到 图 1-57 显示 的 帮助 信息 。 


Usage: 


androtd [global opttons] action [action options] 
Global options: 


-h --help : Help on a specific command. 
-V -verbose : Verbose mode, shows errors, warnings and all messages. 


图 1-57 验证 AndroidSDK 安装 效果 
1.3.7 在 Linux 平台 上 下 载 并 安装 Android NDK 
Android 原生 开发 工具 包 (NDK) 是 Android SDK 的 伴随 工具 ， 可 以 让 用 户 用 诸如 C++ 
的 原生 编程 语言 开发 Android 应 用 程序 。Android NDK 提供 了 头 文件 、 库 和 交叉 编译 器 工 


具 链 。 本 书 编写 时 , Android NDK 的 最 新 版 本 是 R8。 请 到 http://developerandroid.conytools/ 
sdk/ndk/index.html 网 站 下 载 Android NDK， 下 载 部 分 如 图 1-58 所 示 。 下 载 步骤 如 下 : 


哪 Androld NDK1Android Develo... [中 


$ [developer androld com/tools/ sdk/ndk/inden htmlsDownlonds = | |@] = Androld NOK 
和 Downloads 


Exploring the SDK 


Wiorkflew Windows androld -ndi-t8-windows2lp = 109928336 3Tb1a2576129752fcc0gelb9cOTe3f14 
bytes 
Tools Help 


MacOS Xx [intel) android-nd-I8-darwin 96650992 bytes 。 8$1cs5de731f945692123b377afe0bad9 
Revistons v 06 Lachz2 


Linux 32/64-bit (android-ndk-B- linus B8310791 bytes 。 5c9afc9695ed67c61f82fbf396803c05 
Extras v (zx x86 tar br2 


1-58 Android NDK 下 载 页 面 
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(1) 打开 终端 窗口 进入 目标 目录 ~/android。 
(2) Android NDK 安装 包 以 BZIP'ed TAR 的 形式 提供 ， 执 行 tar jxvf `/Downloads/ 
android-ndk-r8-linux-x86.tar.bz2 解压 文件 ， 如 图 1-59 所 示 。 


5 cd ~/android 

$ tar jxvf -/Downloads/android-ndk-ra-linux-x86.tar.bz2 
androtd-ndk-rs/ 

androld-ndk-re/prebuilt/ 
android-ndk-r8/prebuilt/linux-x86/ 
android-ndk-r8/prebuilt/linux-x86/bin/ 
androld-ndk-re/prebutilt/linux-x86/bin/awk 


图 1-59 安装 Android NDK 


为 了 便于 访问 , 要 把 Android NDK 二 进 制 路 径 追加 到 系统 可 执行 文件 搜索 路 径 中 。 打 
开 一 个 终端 窗口 并 执行 下 列 命 令 (如 图 1-60 所 示 ): 


$s echo export ANDROID_NDK_HOME=~/android/androld-ndk-r8 >> ~/.bashrc 
s 六 export PATH=\$ANDROID_NDK_HOME:\SPATH >> -/.bashrc 
$ 


1-60 将 Android NDK 二 进 制 路 径 追 加 到 系统 PATH 变量 中 


® echo export ANDROID NDK HOME = ~/android/android-ndk-r8 > > 
~/ .bashrc 
® echo export PATH = \$ANDROID NDK HOME:\$PATH > > ~/.bashrc 
打开 一 个 终端 窗口 ， 在 命令 行 方式 下 执行 命令 ndk-build 以 验证 Android NDK 的 安装 
效果 。 如 果 安 装 成 功 ， 会 看 到 NDK 给 出 的 关于 项 目 目录 的 提示 ， 如 图 1-61 所 示 。 


ndroid NDK: Could not find application project directory ! 


Androtd NDK: Please deftne the NDK_PROJECT_PATH variable to point to it. 

/home/ctinar /androtd/androtid-ndk-r8/build/core/build-local.mk:130: *** Androtd NDK: A 
borting 。 Stop. 

sl 


1-61 验证 Android NDK 安装 情况 
1.3.8 在 Linux 平台 上 下 载 并 安装 Eclipse 


Eclipse 是 高 度 可 扩展 的 、 多 语言 集成 开发 环境 。 尽 管 原生 Android 应 用 程序 开发 不 要 
求 必须 安装 Eclipse, 但 是 Eclipse 提供 了 高 度 集成 的 编码 环境 , 它 与 Android 工具 结合 使 用 
从 而 简化 应 用 程序 的 开发 。 本 书 编写 时 , Eclipse 的 最 新 版 本 是 Juno 4.2, 请 访问 http://www. 
eclipse.org/downloads/ 网 站 下 载 Eclipse， 如 图 1-62 所 示 ， 下 载 步骤 如 下 : 
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国 Eclipse pownioads 
和 [ 国 cdipse org Jwrl0nd 


Eclipse IDE for Java EE Developers 219 ye mene 32 ER 


Demnpaded 23.9 Tmes Detats Umer 64 Bk 


Eclipse Classic 42 102 we ‘Une 32 Bk 
Dammtaied 6 S19 Tines Details,_ /beer Domniones pe 64 BE 


Ecl IDE for Java Developers. 2 1 
[= He- Q7 FUNCTIONAL 


TFSTING 


图 1-62 ”Eclipse 下 载 页面 


(1) 从 列表 中 下 载 Eclipse Classic for Linux 32 Bit。 

(2) 打开 一 个 终端 窗口 并 进入 目标 目录 ~/android。 

(3) Eclipse 安装 包 以 GZIP'ed TAR 形式 提供 ， 通 过 在 命令 行 方式 下 执行 命令 tar xvf 
“/Downloads/eclipse-SDK-4.2- linux-gtk.tar.gz 进行 文件 解压 缩 ， 如 图 1-63 所 示 。 


$ cd -/androtd 
$ tar zxvf -/Downloads/eclipse-SDK-4.2-Linux-gtk. tar .gz 
clipse/ 
‘eclipse/libcatro-swt.so 
‘eclipse/.eclipseproduct 
eclipse/features/ 
‘eclipse/features/org.eclipse.sdk_4.2.6.v26126528-1648-7T7oDFDPz-3FepgRqG6kkFFY8UF4_o 


1-63 ”安装 Eclipse 


为 了 验证 Eclipse 安装 结果 的 有 效 性 ， 进入 eclipse 目录 并 在 命令 行 方式 下 执行 命令 
eclipse。 如 果 安 装 成 功 ， 就 会 看 到 如 图 1-64 所 示 的 Eclipse Workspace Launcher 对 话 框 。 


Select a workspace 


Eclipse SDK stores your projects ina folder called a workspace. 
Choosea workspace folder to use For this session. 


Workspace: |/home/cinar/android/workspace 回 


[ee Cs |] 


图 1-64 验证 Eclipse 安装 结果 


1.4 下 载 并 安装 ADT 


Android 开发 工具 (Android Development Tools, ADT) 是 Android C++ 开 发 环境 的 平台 独 
立 组 件 ， 它 必须 安装 在 所 有 三 种 操作 系统 上 。 


口 use this as the default and do notask again | 
| 
| 
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Eclipse 平台 是 以 插件 的 概念 为 基础 构建 而 成 ,ADT 是 Eclipse 平台 上 用 于 进行 Android 
应 用 程序 开发 的 插件 集合 , ADT 是 遵循 开源 Apache 许可 的 免费 软件 。 关于 ADT 最 新 版 本 
的 更 多 信息 以 及 最 新 的 安装 步骤 请 参见 http://developer.android.com/sdk/eclipse-adt.html 网 
站 上 Eclipse 页 面 的 ADT 插件 部 分 内 容 。 我 们 将 使 用 Eclipse 的 Install New Software 向 导 来 
安装 ADT: 

(1) 在 顶级 菜单 栏 中 选择 Help | Install New Software 启动 安装 向 导 ， 如 图 1-65 所 示 。 


Fie Edt Novioatc Scorch Proiccl Run Window Heip 
[EO 

| i em 
多 Search 


” 司 " ee 


Tips and Tiicks 
Cheal Sheets 


5 | 国 welcome 电 


Welcome to Emenee 


About Eciipse SDK 


图 1-65 ”Eclipse 安装 新 软件 
(2) 安装 向 导 将 启动 并 显示 可 用 插件 列表 。 因 为 ADT 不 是 Eclipse 官方 软件 库 的 组 成 
部 分 ， 用 户 需要 先 添 加 Android 的 Eclipse 软件 库 作为 一 个 新 软件 站 点 。 为 完成 此 项 任务 ， 
单 击 Add 按钮 ， 如 图 1-66 所 示 。 


3 instal 


Available Software 
Select a site or enter the location of a site_ 


filter text 


DO Thereis no ste sdected. 


图 1-66 添加 新 软件 库 


(3) 出 现 Add Repository 对 话 框 。 在 Name 字段 中 输入 Android ADT, 并 在 Location 字 
段 中 输入 Android 的 Eclipse 软件 库 的 URL:https://dl-ssl.google.com/android/eclipse/， 如 
图 1-67 所 示 。 
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Name- |Android ADT 


@ EI 


图 1-67 添加 Android ADT 软件 库 


(4) 单 击 OK 按钮 添加 新 软件 站 点 。 
(5) Install New Software 向 导 将 显示 可 用 ADT 插件 列表 ， 如 图 1-68 所 示 。 其 中 的 每 一 
个 插件 对 Android 应 用 程序 开发 都 至 关 重 要 ， 强 烈 推 荐 安装 所 有 插件 。 


多 Install 


Available Software 
Check the items that you wish to install 


ype filter text | 


[Name | 
田 回 出 Developer Tools 
回回 JW NDK Plugins 


iect A || Deselect NI | Gitems selected 


图 1-68 安装 ADT 


(6) 单 击 Select All 按钮 选择 所 有 的 ADT 插件 。 

(7) 单 击 Next 按钮 进入 下 一 步 操 作 。 

(8) Eclipse 将 浏览 选中 的 插件 列表 以 将 所 有 的 相关 组 件 追 加 到 列表 中 ， 然 后 会 显示 最 
后 的 下 载 列 表 让 用 户 核查 。 单 击 Next 按钮 进入 下 一 步 操作 。 

(9) ADT 含有 一 系列 遵守 不 同 许可 协议 的 第 三 方 组 件 。 在 安装 过 程 中 ，Eclipse 会 显示 
每 个 软件 的 许可 协议 ， 让 用 户 接收 许可 协议 的 内 容 才 可 以 继续 安装 过 程 。 选 择 接收 许可 协 
议 ， 单 击 Finish 按钮 开始 安装 过 程 。 

在 未 签约 的 JAR 文件 中 的 ADT 插件 会 触发 安全 警告 ， 如 图 1-69 所 示 。 单 击 OK 按钮 
忽略 警告 并 继续 安装 。 当 ADT 插件 安装 完成 时 ，Eclipse 需要 重启 从 而 使 所 做 的 修改 生效 。 


S Security Waning 


Waming: You are installing software that contains unsigned content. The 
企 authenticity or validity of this software cannot be established. Do you want to 
continue with the installation? 


1-69 ”安全 警告 
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重启 时 ，ADT 将 询问 Android SDK 的 位 置 。 选 择 Use existing SDKs， 并 使 用 Browse 
按钮 选择 Android SDK 的 安装 目录 ， 如 图 1-70 所 示 。 
地 Welcome to Android Development 画 回 四 
Welcome to Android Development 
A 5DK Platform Tools component is missing! Please use the SDK Manager to install it- 


versions of Android to test with_ 
O Install new SDK 


同 mstall the letest availablc version of Android APs (supports all the lalest fcaturcs) 


口 mstal Android 22. a version which is supported by ~“93% phones and tablets 
(You can odd addiliond pletforms using the SDK Monager) 


Tarect Location: | 


To develop for Androld. you need an Amdroid SDK. and at least one version of the Androtd APls to 
compile againat. You may also want additional 


图 1-70 选择 Android SDK 位 置 
单 击 Next 按钮 进入 下 一 步 操 作 。 


1.4.1 安装 Android 平台 包 


选择 了 Android SDK 位 置 之 后 ,ADT 验 证 Android SDK 和 Android Platform 包 。Android 
SDK 安装 程序 只 包含 Android 开发 工具 , Android Platform 包 需 要 单独 安装 这样 才 能 构建 


Android 应 用 程序 。 验 证 完成 后 ， 显 示 SDK 验证 警告 对 话 框 ， 如 图 1-71 所 示 。 
[Basasoxveiicso 2 | 


SDK Platform Tools 


component is missing! 
Please use the SDK Manager to install it- 


Open SDK Nanager 


图 1-71 ADT Android SDK 验证 
单 击 Open SDK Manager 按钮 启动 Android SDK Manager， 按 照 图 1-72 所 示 
行 操作 。 


示 的 步骤 进 
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时 Android SDK Manager 


i 二 - 回 目 SewrvesforArdoy SDK 


Show: 同 Updates/New 网 Installed [Obsolete Select New or Updates 


Sort by- © APIIevel © Reposiory Deselect Al 


[ 
Done looding packoges. 


图 1-72 Android SDK 管理 器 


(1) 从 可 用 包 列 表 中 展开 Tools 目录 ， 并 选择 Android SDK Platform-Tools。 

(2) 选择 Android 4.0 (API 14) 类 别 。 

(3) 单 击 Install N Packages 按钮 开始 安装 。 

Android SDK 管理 器 将 显示 选中 包 的 许可 协议 ， 接 受 所 有 的 许可 协议 继续 安装 。 


1.4.2 配置 模拟 器 


Android SDK 带 有 一 个 功能 齐全 的 模拟 器 ， 该 模拟 器 是 一 个 在 用 户 的 机 器 上 运行 的 虚 
拟 设备 。Android 模拟 器 可 以 让 你 在 机 器 上 本 地 开发 和 测试 Android 应 用 程序 ， 而 不 需要 使 
用 物理 设备 。 

Android 模拟 器 运行 一 个 包括 Linux 内 核 的 完整 Android 系统 栈 。 它 是 可 以 模仿 真实 设 
备 的 所 有 硬件 和 软件 特性 的 完全 虚拟 的 设备 ， 每 一 个 特征 都 可 以 用 Android 虚拟 设备 管理 
器 (Android Virtual Device，AVD) 来 定制 。 如 图 1-73 所 示 ， 启 动 AVD Manager 主 菜单 中 选 
择 Window | AVD Manager。 

单 击 AVD Manager 对 话 框 右 侧 的 New 按钮 定义 一 个 新 的 模拟 器 配置 ， 如 图 1-74 
所 示 。 
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等 Java - Eclipse SDK 


Fle Edt Refacdor Navigate Search Project Run | Window Help 


3 | @waone 4 
aa 因 Ee 
| Tutorials YY a Workbench 


Overview 


The Eclipse software development 
class Java programming tools, and 曾 Android SDK Manager 


上 


同 Ren Android Lint » 


C/C++ Development Pralersnoss 


图 1-73 AVD Manager 菜单 


沪 Android Virtual Device Manager 
List of existing Android Virtual Devices located at C:\android\android-sdk-windows\ android\avd 


~ A valkid Android Virtual Dovice. (| A repairable Android Virtual Device-. 
X An Mndroid Virtual Device that failed to load. Qlick "Details' to see the error. 


1-74 AVD Manager 


在 本 书 中 ， 通 常 在 完成 了 资源 配置 之 后 使 用 Android 模拟 器 。 推 荐 使 用 下 面 的 虚拟 机 
配置 执行 本 书 中 的 示例 代码 ， 按 照 下 面 的 说 明 设置 各 字段 值 ， 如 图 1-75 所 示 。 

eName 参数 应 设置 为 Android_ 14。 

e Target 参数 应 设置 为 Android 4.0- APILevel 14。 

e SD Card 的 大 小 应 设置 为 至 少 128 MB 。 

其 他 参数 可 以 使 用 默认 值 。 

为 了 验证 新 定义 的 模拟 器 配置 打开 AVD Manager， 从 列表 中 选择 所 配置 的 模拟 器 名 
称 。 单 击 Start 按钮 启动 模拟 器 实例 。 如 果 配 置 成 功 ， 将 会 出 现 模拟 器 (如 图 1-76) 所 示 。 
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这 Create new Android Vitual Device (AVD) 


Name: [Android_14 


| Target: Android 4.0 - APl Level 14 


CPU/ABI: |ARM (armeabi-v7a) | 
SD Card- 


as [am 可 
ORe: [ee 


图 1-75 ”新建 模拟 器 配置 


图 1-76 新 定义 的 模拟 器 配置 运行 
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1.5 小 结 


本 章 通过 在 目标 操作 系统 上 安装 Android 开发 工具 及 其 相关 组 件 配置 你 的 Android 
C++ 开发 环境 ， 定 义 了 Android 模拟 器 配置 以 执行 以 后 章节 中 将 出 现 的 示例 代码 ， 第 2 章 
将 详细 介绍 Android NDK。 
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第 章 


深入 了 解 Android NDK 


在 第 1 章 中 我 们 通过 安装 Android 开发 工具 及 其 相关 工具 配置 了 开发 环境 。 在 这 些 工 
具 中 ，Android 原生 开发 包 (NDK) 将 用 于 Android 平台 上 的 C++ 开发 。Android NDK 是 
Android 软件 开发 包 (SDK) 的 相关 工具 集 ， 用 来 扩展 Android SDK 的 功能 ， 从 而 使 开发 人 员 
能 够 使 用 机 器 代码 生成 的 编程 语言 (如 C、C++ 和 汇编 语言 ) 实 现 一 些 对 代码 性 能 要 求 较 高 的 
模块 并 将 这 些 模块 嵌入 到 Android 应 用 程序 中 。 

本 章 开始 深入 探讨 Android NDK。 我们 将 使 用 Android NDK 自 带 的 hello-jni 示例 程序 
来 学 习 Android NDK 的 构建 系统 。 


2.1 Android NDK 提供 的 组 件 


Android NDK 不 是 一 个 单独 的 工具 ; 它 是 一 个 包含 API、 交 叉 编译 器 、 链 接 程 序 、 调 
试 器 、 构 建 工 具 、 文 档 和 示例 应 用 程序 的 综合 工具 集 。 以 下 是 Android NDK 的 一 些 主要 
组 件 : 

ARM、x86 和 MIPS 交叉 编译 器 
Java 原生 接口 头 文件 

C 库 

Math 库 

POSIX 线程 

最 小 的 C++ 库 

ZLib 压缩 库 

动态 链接 库 

Android 日 志 库 

Android 像素 缓冲 区 库 


Android C++ 高 级 编程 一 一 使 用 NDK 
. 
. 
. 
. 


2.2 Android NDK 的 结构 


Android 原生 应 用 APIs 
OpenGL ES 3D 图 形 库 
OpenSL ES 原生 音频 库 
OpenMAX AL 最 小 支持 


在 安装 过 程 中 , 所 有 的 Android NDK 组 件 都 被 安装 在 目标 目录 下 。 下 面 介绍 一 些 重要 
文件 和 子 目录 。 

e ndk-build: 该 shell 脚本 是 Android NDK 构建 系统 的 起 始点 。 本 章 将 在 深入 学 习 
Android NDK 构建 系统 的 同时 详细 痔 述 ndk-build。 

e ndk-gdb: 该 shell 脚本 允许 用 GUN 调试 器 调试 原生 组 件 。 第 5 章 讨论 原生 组 件 调 
试 时 将 详细 阐述 ndk-gdb。 

endk-stack: 该 shell 脚本 可 以 帮助 分 析 原 生 组 件 崩 省 时 的 堆栈 追踪 。 第 5 章 讨论 原 
生 组 件 的 故障 排除 和 故障 分 析 时 将 详细 阐述 ndk-stack。 

e build: 该 目录 包含 了 Android NDK 构建 系统 的 所 有 模块 。 本 章 将 详细 介绍 Android 

e platforms: 该 目录 包含 了 支持 不 同 Android 目标 版 本 的 头 文件 和 库 文件 。Android 
NDK 构建 系统 会 根据 具体 的 Android 版 本 自动 引用 这 些 文 档 。 

e samples: 该 目录 包含 了 一 些 示 例 应 用 程序 ， 这 些 程序 可 以 体现 Android NDK 的 性 
能 。 示 例 项 目 对 于 学 习 如 何 使 用 Android NDK 的 特性 很 有 帮助 。 

esources: 该 目录 包含 了 可 供 开 发 人 员 导入 到 现 有 的 Android NDK 项 目的 一 些 共享 
模块 。 

e toolchains: 该 目录 包含 目前 Android NDK 支持 的 不 同 目标 机 体系 结构 的 交叉 编译 
器 。Android NDK 目前 支持 ARM、X86 和 MIPS 机 体系 结构 。Android NDK 构建 
系统 根据 选 定 的 体系 结构 使 用 不 同 的 交叉 编译 器 。 

Android NDK 最 重要 的 组 件 是 它 的 构建 系统 ， 它 包含 了 所 有 的 其 他 组 件 。 想 要 更 好 地 

了 解构 建 系统 的 工作 原理 ， 先 看 一 个 示例 。 


2.3 ”以 一 个 示例 开始 


下 面 以 Android NDK 自 带 的 hello-jni 示例 应 用 程序 开始 讲解 。 之 后 可 以 通过 修改 它 来 
展示 Android NDK 构建 系统 所 提供 的 不 同 功能 ， 例 如 : 
建立 一 个 共享 库 
建立 多 种 共享 库 
建立 静态 库 
利用 共享 库 共享 通用 模块 
在 多 种 NDK 项 目 间 共享 模块 
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e 使 用 预 建 库 

e 建立 独立 的 可 执行 文件 

e 其 他 构建 系统 变量 和 宏 

e 定义 新 变量 和 条 件 操作 

打开 第 1 章 安装 好 的 Eclipse IDE。 虽 然 Android NDK 不 要 求 必须 使 用 IDE, 但 使 用 IDE 
可 以 帮助 用 户 直观 地 检查 项 目 结构 和 构建 流 。 在 启动 阶段 ，Eclipse 会 让 你 选择 工作 区 ; 可 
以 选择 默认 值 并 继续 。 


2.3.1 指定 Android NDK 的 位 置 


因为 是 首次 用 工作 区 进行 Android NDK 开发 ， 所 以 需要 指定 Android NDK 的 位 置 。 

(1) 在 Windows 和 Linux 平台 上 , 在 主 菜单 栏 中 选择 Preference 菜单 项 。 在 Mac OSX 
平台 上 ， 使 用 Eclipse 中 的 应 用 程序 菜单 并 且 选 择 Preferences 菜单 项 。 

(2) 如 图 2-1 所 示 ，Preferences 对 话 框 左边 的 窗 格 包含 了 一 个 树 状 的 preference 分 类 列 
表 。 展 开 Android 然后 在 树 状 列表 中 选择 NDK。 


多 Preferences 画 回 加 
NDK 


本 
Androd NDK Preferences Be 
NDK Location [Candroid\anaroid makea (LBowe.) 

We 


At 
CC 


外 

由 Help 

外 Install/Update 

外 -Java 

由 - Plug-in Development 

由- Run/Debuo 

由 -Team 

Me Cr || 
@ Ce ee] 


图 2-1 选择 的 Android NDK 位 置 


(3) 在 右边 的 窗 格 中 ， 单 击 Browse 按钮 ， 并 利用 文件 浏览 器 选择 Android NDK 安装 
位 置 。 

选择 的 NDK 位 置 仅 对 当前 Eclipse 工作 区 有 效 。 如 果 以 后 要 用 其 他 工作 区 ， 需 要 重复 
以 上 过 程 。 


2.3.2 ”导入 示例 项 目 


上 节 已 经 讲 过 ,在 samples 目录 下 包含 了 Android NDK 安装 程序 自 带 的 示例 应 用 程序 。 
现在 可 以 使 用 其 中 的 示例 应 用 程序 。 

在 主 菜单 栏 中 选择 File, 然后 选择 Import 菜单 项 打开 Import 向 导 。 在 导入 资源 列表 中 ， 
展开 Android 并 选择 Existing Android Code into Workspace， 如 图 2-2 所 示 。 单 击 Next 按钮 


37 


Android C++ 高 级 编程 一 一 使 用 NDK 


进行 下 一 步 。 


图 2-2 将 现 有 的 Android 代码 导入 到 工作 区 中 


如 图 2-3 所 示 ， 使 用 Browse 按钮 打开 文件 资源 管理 器 并 进入 <Android NDK>/samples/ 
hello-jni 目录 。hello-jni 项 目 是 一 个 简单 的 “Hello World” 的 Android NDK 项 目 。 项目 目 录 
包含 实际 项 目 和 测试 项 目 。 为 了 简化 问题 ， 先 不 选择 测试 项 目 ， 只 选 主 项 目 。 不 对 Android 
NDK 安装 目录 做 任何 修改 是 保证 安全 的 正确 做 法 。 选 中 Copy projects into workspace 选项 
让 Eclipse 将 项 目 代 码 复制 到 工作 区 ， 这 样 就 可 以 对 副本 而 不 是 原始 项 目 进 行 操作 。 单 击 
Next 按钮 开始 将 项 目 导入 工作 区 。 


Import Projedts 
Select a directory to search for existing Android projects 


NE | ET 


@ Cx T Ms J] Bn] cme |] 


2-3 ”导入 hello-jni Android NDK 项 目 
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如 图 2-4 所 示 ， 在 导入 过 程 的 最 后 一 步 ， 控 制 台 会 出 现 一 个 错误 信息 。 回 顾 第 1 章 的 
内 容 ， 那 里 只 用 SDK Manager 下 载 了 适用 于 Android 4.0(API Level 14) 平 台 的 APIS。 而 
hello-ini 项 目 是 基于 Android 1.5(API Level 3) 开 发 的 。 


区 Problems 六 Tasks 目 Console X 国 Properties 
Android 
[2012-07-10 14:23:08 - com_example hellojni HelloJni] Unable to resolve ta 


图 2-4 不 能 解决 目标 APILevel3 


API Levels 是 向 后 兼容 的 ,所 以 不 用 下 载 API Level 3, 而 是 在 Eclipse 的 Project Explorer 
视图 中 右 击 com.example. hellojni. HelloJni 项 目 ， 在 上 下 文 菜单 中 选择 Properties 打开 项 
目 属性 对 话 框 。 项 目 属性 对 话 框 左边 的 窗 格 包含 了 一 个 树 状 的 项 目 属性 分 类 列表 。 在 树 
状 列表 中 选择 Android， 并 在 右边 窗 格 中 选择 Android 4.0 作为 项 目 构建 目标 (如 图 2-5 


2-5 将 Android 4.0 选 为 项 目 构建 目标 
单 击 OK 按钮 确认 上 述 更 改 。Eclipse 会 用 已 选 的 项 目 构建 目标 来 重建 项 目 。 
2.3.3 向 项 目 中 添加 原生 支持 


Import Android Project 向 导 只 将 项 目 作 为 Android Java 项 目 导 入 。 为 了 让 构建 流 包 含 原 
生 组 件 ， 需 要 手动 添加 原生 支持 。 在 Eclipse 的 Project Explorer 视图 中 右 击 com.example. 
hellojni.HelloJni 项 目 ， 鼠 标 停 在 Android Tools 菜单 项 上 并 在 上 下 文 菜单 中 选择 Add Native 
Support。 打 开 Add Android Native Support 对 话 框 ， 如 图 2-6 所 示 。 由 于 该 项 目 已 经 包含 了 
-个 原生 项 目 ， 所 以 库 名 可 以 保持 不 变 ， 单 击 Finish 按钮 继续 。 
如 果 是 第 一 次 向 Java-only 项 目 中 添加 原生 支持 , 可 以 在 该 对 话 框 中 指定 首选 的 共享 库 
名 ， 在 将 构建 文件 自动 生成 为 进程 的 一 部 分 时 会 使 用 该 首选 共享 库 名 称 。 
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图 2-6 添加 Android 原生 支持 
2.3.4 运行 项 目 


现在 已 经 完成 了 项 目的 编写 ， 可 以 在 Android 模拟 器 上 运行 该 项 目 。 在 主 菜 单 上 选择 
Run， 然 后 在 子 菜单 中 选择 Run。 因 为 是 第 一 次 运行 该 项 目 ，Eclipse 会 通过 Run As 对 话 框 
让 用 户 选择 该 项 目的 运行 方式 。 在 列表 中 选择 Android Application 并 单 击 OK 按钮 继续 。 
将 会 启动 Android 模拟 器 ; Eclipse 会 自动 部 署 并 执行 该 项 目 ， 如 图 2-7 所 示 。Android 模拟 
器 是 一 个 虚拟 机 ， 它 完全 启动 Android 操作 系统 可 能 需要 花 几 分 钟 的 时 间 。 


554 Androkd_14 


”4 面 10:09 


Hello from JNI ! 


2-7 运行 原生 项 目的 Android 模拟 器 
或 许 你 已 经 注意 到 : 运行 该 项 目的 过 程 和 运行 Java-only 项 目的 过 程 一 模 一 样 。 因 为 向 
项 目 自动 添加 原生 支持 的 同时 已 经 在 用 户 不 知道 的 情况 下 将 必要 步骤 包含 在 构建 过 程 中 
了 。 仍 然 可 以 在 Console 视图 中 查看 Android NDK 构建 系统 发 来 的 消息 ， 如 图 2-8 所 示 。 


区 Problems 局 Tasks 里 Console 2 Properties ES 
CDT Build Console [com example hellojni 
of 


-build™ 

: [arm4inuoc-androideabi-4 4 3] libs/armeabi/gdbserver 
Gdbsetup ‘ libs/armeabi/gdb setup 
Cygwin : Generating dependency file converter script 
Compile thumb - hello-jni <= hellojni c 
SharedUibrary : ibhellojni so 
Install : libhello-jni so => libs/armeabi/ibhellojni so 
15:06:09 Build Fnished (took 3s 815ms) 


图 2-8 显示 Android NDK 构建 信息 的 Console 视图 
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尽管 Eclipse 可 以 很 好 地 简化 整个 构建 和 部 署 过 程 ， 但 就 像 本 章 之 前 所 提 到 过 的 ， 
Eclipse 不 是 构建 Android NDK 项 目的 必要 条 件 ， 整 个 构建 过 程 也 可 以 用 命令 行 方式 执行 。 


2.3.5 用 命令 行 对 项 目 进行 构建 


为 了 在 命令 行 方式 下 构建 hello-jni 项 目 , 首先 在 Windows 中 打开 命令 提示 符 或 在 Mac 
OS 义 或 Linux 中 打开 终端 窗口 ， 并 将 hello-jni project 所 在 目录 更 改 为 当前 工作 目录 。 用 原 
生 组 件 构 建 Android 项 目 需 要 两 步 : 第 一 步 构 建 原生 组 件 ， 第 二 步 构 建 Java 应 用 程序 并 将 
Java 应 用 程序 与 其 原生 组 件 打 包 。 为 构建 原生 组 件 ， 在 命令 行 方式 下 执行 ndk-build。 
ndk-build 是 一 个 调用 Android 构建 系统 的 辅助 脚本 。 如 图 2-9 所 示 ，Android NDK 构建 脚 
本 会 在 构建 过 程 中 输出 进度 消息 。 


[FE] C:\windows\system3Z2\cmd .exe [lolx| 


ND example- 人 Hoa build 
dhserver [arm-linux-androideabi-4.4.3] libs/arneabi/gdbserver 


mb j 
: libhello-jni 
=: 1ibl 


-SO 
hello-jni-so => libs/armeabi/libhello-jni.so 
:\android\workspace\com.exanple .hellojni.HelloJni>. 


图 2-9 用 ndk-build 对 原生 组 件 进行 构建 


现在 完成 了 原生 组 件 的 构建 ， 可 以 继续 第 二 步 。Android SDK 构建 系统 是 基于 Apache 
ANT 的 。 因 为 这 是 第 一 次 用 命令 行 构建 项 目 ， 所 以 首先 应 该 生成 Apache ANT 构建 文件 。 
在 命令 行 中 执行 android update project -p . -n hello-jni -t android-14--subprojects 命令 来 生成 
Apache ANT 构建 文件 ， 如 图 2-10 所 示 。 

现在 Apache ANT 构 建文 档 的 编写 已 经 完成 , 可 以 通过 在 命令 行 方式 下 执行 “ant debug” 
命令 构建 项 目 ，Apache ANT 将 构建 Java 文件 并 将 该 Java 文件 与 原生 组 件 打 成 一 个 可 安装 
Android 包 ， 即 APK 文件 。 通 过 上 述 操作 可 以 看 出 ， 构 建 带 有 原生 构件 的 Android 应 用 最 
简单 的 方式 是 使 用 Eclipse， 因 为 不 需要 记 住 每 一 个 构建 操作 步 ， 所 以 不 易 出 错 。 


EY C:\windows\system32\cmd exe 


androidyworkspace eon exanple :helloini.HelloJni>android update project -p - 
hello-ini tandroid 14 —subprojee 

paated Yrojiget. properties 

pdated ocaT properties 
ded £129 :Sandroid orkepace\ con eanple i hello odl9dnS Nid 

paated File C:\android\workspace\con.exanpie.hellojni. Nt 


istea and renamed default.properties to project.properties 
lated local.properties 


rr 
dded file C:\android\workspace\con.exanple.hellojni-HelloJni\bin\proguard-proje 
-txt 


dnd te 
dE ni.HelloJni\tests\proguard-p 
ject .tx 


:\android\workspace\con.exanple .hellojni.HelloJni>. 


图 2-10 生成 Apache ANT 构建 文件 
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2.3.6 检测 Android NDK 项 目的 结构 


现在 重新 回 到 Eclipse 环境 下 学 习 带 有 原生 组 件 的 Android 应 用 程序 的 结构 。 如 图 2-11 
所 示 ， 带 有 原生 组 件 的 Android 项 目 包含 一 组 附加 的 目录 和 文件 。 


图 2-11 Hello-jni Android NDK 项 目的 结构 


e jni: 该 目录 包含 原生 组 件 的 源 代码 以 及 描述 原生 组 件 构建 方法 的 Android.mk 构建 
文件 。 Android NDK 构建 系统 将 该 目录 作为 NDK 项 目 目录 并 希望 在 项 目 根 目 录 中 
找到 它 。 

。 Libs: 在 Android NDK 构建 系统 的 构建 过 程 中 创建 该 目录 。 它 包含 指定 的 目标 机 
体系 结构 的 独立 子 目录 ,例如 ARM 的 armeabi,. 在 打包 过 程 中 该 目录 被 包含 在 APK 
文件 中 。 

。 Obj: 这 是 一 个 中 间 目 录 ， 编译 源 代码 后 所 产生 的 目标 文件 都 保存 在 该 目录 下 。 开 
发 人 员 最 好 不 要 访问 该 目录 。 

Android NDK 项 目 最 重要 的 组 件 是 Android.mk 构建 文件 , 该 文档 描述 了 原生 组 件 。 理 

解构 建 系统 是 熟练 运用 Android NDK 及 其 所 有 组 件 的 关键 。 


2.4 构建 系统 


Android NDK 的 构建 系统 是 基于 GUN Make 的 。 该 构建 系统 的 主要 目的 是 使 开发 人 员 
能 够 用 很 短 的 构建 文档 来 描述 原生 的 Android 应 用 程序 ， 该 构建 系统 还 处 理 了 包括 替 开 发 
人 员 指定 工具 链 、 平 台 、CPU 和 ABI 等 很 多 细节 。 封 装 该 构建 过 程 可 以 在 不 改变 构建 文件 
的 情况 下 ， 使 Android NDK 的 后 续 更 新 添加 更 多 对 工具 链 、 平 台 以 及 系统 接口 的 支持 。 

Android NDK 构建 系统 是 由 多 种 GUN Makefile 片段 构成 的 。 该 构建 系统 包括 基于 演 
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染 构建 过 程 的 不 同类 型 NDK 项 目 所 需要 的 必要 片段 。 如 图 2-12 所 示 ， 这 些 构建 系统 片段 
可 以 在 Android NDK 安装 程序 的 build/core 子 目录 中 找到 。 虽 然 开 发 人 员 并 不 会 直接 接触 
到 这 些 文件 ， 但 知道 它们 的 位 置 对 与 构建 系统 相关 的 故障 很 有 帮助 。 


图 2-12 AndroidNDK 构建 系统 片段 


除了 这 些 片段 ，Android NDK 构建 系统 还 要 依赖 另外 两 个 文件 : Android.mk 和 
Application.mk， 这 两 个 文件 应 该 作为 NDK 项 目的 一 部 分 由 开发 人 员 提供 ， 让 我 们 来 回顾 
下。 


2.4.1 Android.mk 


Androidmk 是 一 个 向 Android NDK 构建 系统 描述 NDK 项 目的 GUN Makefile 片段 。 
它 是 每 一 个 NDK 项 目的 必 备 组 件 。 构 建 系统 希望 它 出 现在 jni 子 目录 中 。 在 Eclipse 的 Project 
Explorer 中 ， 双 击 Android.mk 文件 在 编辑 视图 中 打开 它 。 程 序 清单 2-1 显示 了 hello-jni 项 
目 中 Android.mk 文件 的 内 容 。 


程序 清单 2-1 ”hello-jni 项 目下 Android.mk 文件 的 内 容 


# Copyright (C) 2009 The Android Open Source Project 

# 

# Licensed under the Apache License, Version 2.0 (the "License"); 
# you may not use this file except in compliance with the License. 
# You may obtain a copy of the License at 

# 
# http://www.apache.org/licenses/LICENSE-2.0 
# 
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# Unless required by applicable law or agreed to in writing, software 

# distributed under the License is distributed on an "AS IS" BASIS, 

# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 
# See the License for the specific language governing permissions and 

# limitations under the License. 

非 

LOCAL PATH := $(call my-dir) 


include $ (CLEAR VARS) 


LOCAL MODULE := hello-jni 
LOCAL SRC FILES := hello-jni.c 


include $ (BUILD SHARED LIBRARY) 


为 了 更 好 地 理解 它 的 句法 ， 我 们 逐 行 分 析 。 因 为 这 个 是 一 个 GUN Makefile 片段 ， 所 
以 它 的 句法 和 其 他 Makefile 是 一 样 的 。 每 行 都 包含 一 个 单独 的 指令 ， 以 “# ”开头 的 是 注 
释 行 ，GUN Make 工具 不 处 理 它 们 。 根 据 命名 规范 ， 变 量 名 要 大 写 。 

注释 块 后 的 第 一 条 指令 是 用 来 定义 LOCAL PATH 变量 的 。 根 据 Android 构建 系统 的 
要 求 ，Android.mk 文档 必须 以 LOCAL PATH 变量 的 定义 开头 。 


LOCAL PATH :=$ (call my-dir) 


Android 构建 系统 利用 LOCAL PATH 来 定位 源 文件 。 因 为 将 该 变量 设置 为 硬 编码 值 并 
不 合适 ， 所 以 Android 构建 系统 提供 了 一 个 名 为 my-dir 的 宏 功能 。 通 过 将 该 变量 设置 为 
my-dir 宏 功 能 的 返回 值 ， 可 以 将 其 放 在 当前 目录 下 。 

Android 构 建 系统 将 CLEAR_VARS 变量 设置 为 clear-vars.mk 片段 的 位 置 ,包含 Makefile 
片段 可 以 清除 除了 LOCAL PATH 以 外 的 LOCAL _<name> 变 量 , 例如 LOCAL _ MODULE 
与 LOCAL SRC FILES 等 。 

Include $ (CLEAR VARS) 

这 样 做 是 因为 Android 构建 系统 在 单 次 执行 中 解析 多 个 构建 文件 和 模块 定义 ， 而 
LOCAL <name> 是 全 局 变量 。 清 除 它们 可 以 避免 冲突 ， 每 一 个 原生 组 件 被 称 为 一 个 模块 。 

LOCAL MODULE 变量 用 来 给 这 些 模 块 设 定 一 个 唯一 的 名 称 。 下 面 的 代码 将 该 模块 的 
名 称 设 为 hello-jni: 

LOCAL MODULE := hello-jni 

因为 模块 名 称 也 被 用 于 给 构建 过 程 所 生成 的 文件 命名 ， 所 以 构建 系统 给 该 文件 添加 了 
适当 的 前 级 和 后 级 。 本 例 中 ，hello-jni 模块 会 生成 一 个 共享 库 文件 且 构 建 系统 会 将 它 命名 
为 libhello-jni.so。 

用 LOCAL _SRC _FILES 变量 定义 用 来 建立 和 组 装 这 个 模块 的 源 文件 列表 。 


LOCAL SRC FILES := hello-jni.c 


这 里 ，hello-jni 模块 只 由 一 个 源 文件 生成 ， 而 LOCAL SRC _FILES 变量 可 以 包含 用 空 
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格 分 开 的 多 个 源 文件 名 。 

至 此 ，Android.mk 文件 中 定义 的 构建 系统 变量 简单 描述 了 原生 项 目 。 编 译 和 生成 实际 
模块 的 构建 系统 还 需要 包含 合适 的 构建 系统 片段 ， 具 体 需 要 包含 哪些 片段 取决 于 想 要 生成 
模块 的 类 型 。 


1. 构建 共享 库 


为 了 建立 可 供 主 应 用 程序 使 用 的 模块 ， 必 须 将 该 模块 变 成 共享 库 。Android NDK 构建 
系统 将 BUILD_SHARED_ LIBRARY 变量 设置 成 build-shared-library.mk 文件 的 保存 位 置 。 
该 Makefile 片段 包含 了 将 源 文件 构建 和 组 装 成 共享 库 的 必要 过 程 : 


include $(BUILD SHARED LIBRARY) 


hello-jni 是 一 个 简单 的 模块 然而， 除非 你 的 模块 需要 特殊 处 理 ， 否 则 Android.mk 文 
档 将 会 包含 一 模 一 样 的 流程 和 指令 。 


2. 构建 多 个 共享 库 


基于 不 同 的 应 用 程序 的 体系 结构 , 一 个 单独 的 Android.mk 文档 可 能 产生 多 个 共享 库 模 
块 。 为 了 达到 这 个 目的 ， 需 要 如 程序 清单 2-2 所 示 在 Android.mk 文档 中 定义 多 个 模块 。 


程序 清单 2-2 带 有 多 个 共享 库 模块 的 Android.mk 构建 文件 


LOCAL PATH := $(call my-dir) 
# 

# 模 块 1 

# 

include $ (CLEAR VARS) 

LOCAL MODULE := modulel 
LOCAL SRC _ FILES := modulel.c 
include $ (BUILD SHARED LIBRARY) 
# 

# 模 块 2 

# 

include $ (CLEAR VARS) 


LOCAL MODULE := module2 
LOCAL SRC_FILES := module2.c 


include $ (BUILD SHARED LIBRARY) 


在 处 理 完 这 个 Android.mk 构建 文档 之 后 , Android NDK 构建 系统 会 产生 libmodulel.so 
和 libmodule2.so 两 个 共享 库 。 
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3. 构建 静态 库 


Android NDK 构建 系统 也 支持 静态 库 。 实际 的 Android 应 用 程序 并 不 直接 使 用 静态 库 ， 
并 且 应 用 程序 包 中 也 不 包含 静态 库 。 静 态 库 可 以 用 来 构建 共享 库 。 例 如 ， 在 将 第 三 方 代码 
添加 到 现 有 原生 项 目 中 时 ， 不 用 直接 将 第 三 方 源 代码 包括 在 原生 项 目 中 ， 而 是 将 第 三 方 代 
码 编译 成 静态 库 然后 并 入 共享 库 ， 如 程序 清单 2-3 所 示 。 

程序 清单 2-3 ”在 Android.mk 文件 中 使 用 静态 库 


LOCAL PATH := $(call my-dir) 


非 

# 第 三 方 AVI 库 

提 

include $ (CLEAR VARS) 


LOCAL MODULE := avilib 
LOCAL SRC FILES := avilib.c platform posix.c 


include $ (BUILD STATIC LIBRARY) 


# 

# 原生 模块 

# 

include $ (CLEAR VARS) 


LOCAL MODULE := module 
LOCAL SRC FILES := module.c 


LOCAL STATIC LIBRARIES := avilib 


include $ (BUILD SHARED LIBRARY) 


在 将 第 三 方 代码 模块 生成 静态 库 之 后 ， 共 享 库 就 可 以 通过 将 它 的 模块 名 添加 到 
LOCAL _STATIC_LIBRARIES 变量 中 来 使 用 该 模块 。 


4. 用 共享 库 共享 通用 模块 

静态 库 可 以 保证 源 代码 模块 化 ， 但 是 ， 当 静态 库 与 共享 库 相 连 时 ， 它 就 变 成 了 共享 库 
的 一 部 分 。 在 多 个 共享 库 的 情况 下 ， 多 个 共享 库 与 同一 个 静态 库 连 接 时 ， 需 要 将 通用 模块 
的 多 个 副本 与 不 同 共享 库 重 复 相连 ， 这 样 就 增加 了 应 用 程序 的 大 小 。 在 这 种 情况 下 ， 不 用 
构建 静态 库 ， 而 是 将 通用 模块 作为 共享 库 建 立 起 来 ， 而 动态 连接 依赖 模块 以 便 消除 重复 的 
副本 ( 见 程序 清单 2-4)。 

程序 清单 2-4 ”Android.mk 文件 中 共享 库 之 间 的 代码 共享 


LOCAL PATH := $(call my-dir) 
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非 

# 第 三 方 AVI 库 

非 

include $ (CLEAR VARS) 


LOCAL MODULE := avilib 
LOCAL SRC FILES := avilib.c platform posix.c 


include $ (BUILD SHARED LIBRARY) 


## 

# 原生 模块 1 

# 

include $ (CLEAR VARS) 


LOCAL MODULE := modulel 
LOCAL SRC FILES := modulel.c 


LOCAL SHARED LIBRARIES := avilib 


include $ (BUILD SHARED LIBRARY) 


# 

# 原生 模块 2 

# 

include $ (CLEAR VARS) 


LOCAL MODULE := module2 
LOCAL SRC _ FILES := module2.c 


LOCAL SHARED LIBRARIES := avilib 
include $ (BUILD SHARED LIBRARY) 
5. 在 多 个 NDK 项 目 间 共享 模块 


同时 使 用 静态 库 和 共享 库 时 ， 可 以 在 模块 间 共享 通用 模块 。 但 要 说 明 的 是 ， 所 有 这 些 
模块 必须 属于 同一 个 NDK 项 目 。 从 R5 版 本 开始 ，Android NDK 也 允许 在 NDK 项 目 间 共 
享 和 重用 模块 。 考 虑 前 面 讲 过 的 示例 ， 可 以 通过 以 下 步骤 在 多 个 NDK 项 目 间 共享 avilib 
模块 : 

e 首先 ,将 avilib 源 代码 移动 到 NDK 项 目 以 外 的 位 置 ,例如 :C:\android\shared-modules\ 

avilib。 为 了 避免 命名 冲突 ， 目 录 结 构 也 可 以 包含 模块 提供 者 的 名 字 ， 例 如 : C\ 
android\shared-modules \transcode\avilib。 


注意 : 
在 Android NDK 构建 系统 中 ， 共 享 模块 路 径 不 能 包含 空格 。 


。 作为 共享 模块 ，avilib 需要 自己 的 Android.mk 文件 ， 如 程序 清单 2-5 所 示 。 
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程序 清单 2-5 ”共享 avilib 模块 的 Android.mk 文件 


LOCAL PATH := $(call my-dir) 


非 

# 第 三 方 AVI 库 

# 

include $ (CLEAR VARS) 


LOCAL MODULE := avilib 
LOCAL SRC FILES := avilib.c platform posix.c 


include $ (BUILD SHARED LIBRARY) 


。 现在 , 可 以 将 avilib 模块 从 NDK 项 目的 Android.mk 文件 中 移 除 。 为 了 使 用 这 个 共 
享 模块 ， 将 以 transcode/avilib 为 参数 调用 函数 宏 import-module 部 分 添加 在 构建 文 
档 的 末尾 ,如 程序 清单 2-6 所 示 。 为 了 避免 构建 系统 的 冲突 , 应 该 将 import-module 
函数 宏 调用 放 在 Android.mk 文档 的 末尾 。 


程序 清单 2-6 ”使 用 共享 模块 的 NDK 项 目 


# 

# 原生 模块 

# 

include $ (CLEAR VARS) 


LOCAL MODULE := module 
LOCAL SRC_FILES := module.c 
LOCAL SHARED LIBRARIES := avilib 


include $ (BUILD SHARED LIBRARY) 


$(call import-module, transcode/avilib) 


e import-module 函数 宏 需 要 先 定位 共享 模块 ， 然 后 再 将 它 导入 到 NDK 项 目 中 。 默 
认 情 况 下 ，import-module 函数 宏 只 搜索 <Android NDK>/sources 目录 。 为 了 搜索 
ci\android\shared-modules 目录 ， 定 义 一 个 名 为 NDK_MODULE_PATH 的 新 环境 变 
量 并 将 它 设置 成 共享 模块 的 根 目录 ， 例 如 : ci\android\shared-modules。 


6. 用 Prebuilt 库 


使 用 共享 模块 要 求 有 共享 模块 的 源 代码 ，Android NDK 构建 系统 简单 地 把 这 些 源 文件 
包含 在 NDK 项 目 中 并 每 次 构建 它们 。 自 R5 版 本 以 后 ，Android NDK 也 提供 对 Prebuilt 库 
的 支持 。 在 下 面 的 情况 下 ，Prebuilt 库 是 非常 有 用 的 : 

。 想 在 不 发 布 源 代码 的 情况 下 将 你 的 模块 发 布 给 他 人 。 

。 想 使 用 共享 模块 的 预 建 版 来 加 速 构建 过 程 。 
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尽管 已 经 被 编译 了 ， 但 预 建 模块 仍 需要 一 个 Android.mk 构建 文档 ， 如 程序 清单 2-7 
所 示 。 
程序 清单 2-7“ 预 构建 共享 模块 的 Android.mk 文件 


LOCAL PATH := $(call my-dir) 


# 
# 第 三 方 预 构建 AVI 库 
# 


include $ (CLEAR VARS) 


LOCAL MODULE := avilib 
LOCAL SRC FILES := libavilib.so 


include $ (PREBUILT SHARED LIBRARY) 


LOCAL SRC FILES 变量 指向 的 不 是 源 文件 ， 而 是 实际 Prebuilt 库 相 对 于 LOCAL PATH 
的 位 置 。 


注意 : 
Prebuilt 库 定 义 中 不 包含 任何 关于 该 库 所 构建 的 实际 机 器 体系 结构 的 信息 。 开 发 人 员 需 
要 确保 Prebuilt 库 是 为 与 NDK 项 目 相同 的 机 器 体系 结构 而 构建 的 。 


PREBUILT _ SHARED LIBRARY 变量 指向 prebuilt-shared-library.mk Makefile 片段 。 它 
什么 都 没有 构建 ， 但 是 它 将 Prebuilt 库 复制 到 了 NDK 项 目的 libs 目录 下 。 通 过 使 用 
PREBUILT_STATIC_LIBRARY 变量 ， 静 态 库 可 以 像 共 享 库 一 样 被 用 作 Prebuilt 库 ，NDK 
项 目 可 以 像 普通 共享 库 一 样 使 用 Prebuilt 库 了 。 


LOCAL SHARED LIBRARIES :=avilib 


7. 构建 独立 的 可 执行 文件 


在 Android 平台 上 使 用 原生 组 件 的 推荐 和 支持 的 方法 是 将 它们 打包 成 共享 库 。 但 是 ， 
为 了 方便 测试 和 进行 快速 原型 设计 ，Android NDK 也 支持 构建 独立 的 可 执行 文件 。 这 些 独 
立 的 可 执行 文件 是 不 用 打包 成 APK 文件 就 可 以 复制 到 Android 设备 上 的 常规 Linux 应 用 程 
序 ， 而 且 它 们 可 以 直接 执行 ， 而 不 通过 Java 应 用 程序 加 载 。 生 成 独立 可 执行 文件 需要 在 
Android.mk 构建 文档 中 导入 BUILD_EXECUTABLE 变量 ， 而 不 是 导入 BUILD_SHARED_ 
LIBRARY 变量 ， 如 程序 清单 2-8 所 示 。 


程序 清单 2-8 ”独立 可 执行 模块 的 Android.mk 文件 


非 
# 独立 的 可 执行 的 原生 模块 
# 
include $ (CLEAR VARS) 


49 


Android C++ 高 级 编程 一 一 使 用 NDK 


LOCAL MODULE := module 
LOCAL SRC FILES := module.c 


LOCAL STATIC LIBRARIES := avilib 
include $ (BUILD EXECUTABLE) 


BUILD_EXECUTABLE 变量 指向 build-executable.mk Makefile 片段 ， 该 片段 包含 了 在 
Android 平台 上 生成 独立 可 执行 文件 的 必要 步骤 。 独 立 可 执行 文件 以 与 模块 相同 的 名 称 被 
放 在 libs/<machine architecture> 目 录 下 。 尽管 放 在 该 目录 下 , 但 在 打包 阶段 它 并 没有 被 包含 
在 APK 文件 中 。 


8. 其 他 构建 系统 变量 


除了 在 前 几 节 提 到 的 变量 之 外 ，Android NDK 构建 系统 还 支持 其 他 变量 ， 本 节 将 对 这 
些 变量 进行 简要 说 明 。 

构建 系统 定义 的 变量 有 : 

e TARGET_ARCH: 目标 CPU 体系 结构 的 名 称 ， 例 如 arm 

e TARGET _ PLATFORM: 目标 Android 平台 的 名 称 ， 例 如 : android-3 

e TARGET_ ARCH_ABI: 目标 CPU 体系 结构 和 ABI 的 名 称 ， 例 如 : armeabi-v7a 

e TARGET_ABI: 目标 平台 和 ABI 的 串联 ， 例 如 : android-3-armeabi-v7a 

可 被 定义 为 模块 说 明 部 分 的 变量 有 : 

e LOCAL_ MODULE_FILENAME: 可 选 变量 , 用 来 重新 定义 生成 的 输出 文件 名 称 。 
默认 情况 下 ， 构 建 系统 使 用 LOCAL _ MODULE 的 值 作为 生成 的 输出 文件 名 称 ， 但 
变量 LOCAL MODULE_FILENAME 可 以 覆盖 LOCAL _ MODULE 的 值 。 

。 LOCAL_CPP_EXTENSION: C++ 源 文件 的 默认 扩展 名 是 .cpp。 这 个 变量 可 以 用 来 
为 C++ 源 代码 指定 一 个 或 多 个 文件 扩展 名 。 


LOCAL CPP EXTENSION :=.cpp .Cxx 


。 LOCAL_CPP_FEATURES: 可 选 变量 ,用 来 指明 模块 所 依赖 的 具体 C++ 特性 ， 如 
RTTI、exceptions 等 。 


LOCAL CPP_FERTURES :=rtti 


e LOCAL _C_INCLUDES: 可 选 目录 列表 ,NDK 安装 目录 的 相对 路 径 ， 用 来 搜索 头 
文件 。 


LOCAL C INCLUDES :=sources/shared-module 
LOCAL C_INCLUDES :=$ (LOCAL PATH)/include 
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e LOCAL_CFLAGS: 一 组 可 选 的 编译 器 标志 ， 在 编译 C 和 C++ 源 文 件 的 时 候 会 被 
传送 给 编译 器 。 


LOCAL CFLAGS :=-DNDEBUG -DPORT=1234 


e LOCAL_CPP_FLAGS: 一 组 可 选 的 编译 标志 , 在 只 编译 C++ 源 文件 时 被 传送 给 编 
译 器 。 

。 LOCAL WHOLE_STATIC_LIBRARIES:LOCAL STATIC LIBRARIES 的 变 体 ， 
用 来 指明 应 该 被 包含 在 生成 的 共享 库 中 的 所 有 静态 库 内 容 。 


小 贴 士 : 

当 几 个 静态 库 之 间 有 循环 依赖 时 ，LOCAL WHOLE_STATIC _LIBRARIES 很 有 用 。 

。 LOCAL_ LDLIBS: 链接 标志 的 可 选 列表 ， 当 对 目标 文件 进行 链接 以 生成 输出 文件 
时 该 标志 将 被 传送 给 链接 器 。 它 主要 用 于 传送 要 进行 动态 链接 的 系统 库 列表 。 例 
如 : 要 与 Android NDK 日 志 库 链接 ， 使 用 以 下 代码 : 

LOCAL LDFLAGS :=-11og 

。 LOCAL_ALLOW_UNDEFINED_SYMBOLS: 可 选 参数 ， 它 禁止 在 生成 的 文件 中 
进行 缺失 符号 检查 。 若 没有 定义 ， 链 接 器 会 在 符号 缺失 时 生成 错误 信息 。 

e LOCAL_ARM_MODE: 可 选 参数 ，ARM 机 器 体系 结构 特有 变量 ， 用 于 指定 要 生 
成 的 ARM 二 进 制 类 型 。 默 认 情 况 下 ， 构 建 系统 在 拇指 模式 下 用 16 位 指令 生成 ， 
但 该 变量 可 以 被 设置 为 arm 来 指定 使 用 32 位 指令 。 

LOCAL ARM MODE :=arm 

该 变量 改变 了 整个 模块 的 构建 系统 行为 ， 可 以 用 .arm 扩展 名 指定 只 在 arm 模式 下 
构建 特定 文件 。 

LOCAL SRC FILES :=filel.c file2.c.arm 

e LOCAL_ARM_NEON: 可 选 参数 ，ARM 机 器 体系 结构 特有 变量 ， 用 来 指定 在 源 
文件 中 应 该 使 用 的 ARM 高 级 单 指 令 流 多 数据 流 (Single Instruction Multiple Data， 
SIMD)(a.k.a. NEON) 内 联 函 数 。 


LOCAL ARM NEON :=true 


该 变量 改变 了 整个 模块 的 构建 系统 行为 :， 可 以 用 .neon 扩展 名 指定 只 构建 带 有 
NEON 内 联 函 数 的 特定 文件 。 


LOCAL SRC FILES : =filel.c file2.c.neon 


。 LOCAL _DISABLE_NO_EXECUTE: 可 选 变量 ， 用 来 禁用 NX Bit 安全 特性 。NX 
Bit 代表 Never Execute( 永 不 执行 )， 它 是 在 CPU 中 使 用 的 一 项 技术 ,用 来 隔离 代码 
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区 和 存储 区 。 这 样 可 以 防止 恶意 软件 通过 将 它 的 代码 插入 应 用 程序 的 存储 区 来 控 
制 应 用 程序 。 


LOCAL DISABLE NO EXECUTE :=true 


e LOCAL _EXPORT_CFLAGS: 该 变量 记录 一 组 编译 器 标志 ,这 些 编译 器 标志 会 
添加 到 通过 变量 LOCAL _STATIC_LIBRARIES 或 LOCAL SHARED LIBRARIES 
使 用 本 模块 的 其 他 模块 的 LOCAL _CFLAGS 定义 中 。 


LOCAL MODULE := avilib 


LOCAL EXPORT CFLAGS := — DENABLE AUDIO 


LOCAL MODULE := modulel 
LOCAL CFLAGS := - DDEBUG 


LOCAL SHARED LIBRARIES := avilib 


编译 器 在 构建 modulel 时 会 以 -DENABLE_AUDIO -DDEBUG 标志 执行 。 

e LOCAL EXPORT_CPPFLAGS: 和 LOCAL EXPORT_CLAGS 一 样 ， 但 是 它 是 
C++ 特定 代码 编译 器 标志 。 

e。 LOCAL EXPORT_LDFLAGS: 和 LOCAL EXPORT_CFLAGS 一 样 ， 但 用 作 链 
接 器 标志 。 

e LOCAL EXPORT_C_INCLUDES: 该 变量 允许 记录 路 径 集 ， 这 些 路 径 会 被 添加 
到 通过 变量 LOCAL STATIC _LIBRARIES 或 LOCAL SHARED_ LIBRARIES 使 用 
该 模块 的 LOCAL _C_INCLUDES 定义 中 。 

。 LOCAL_SHORT_COMMANDS: 对 填 有 大 量 资源 或 独立 的 静态 /共享 库 的 模块 ， 
该 变量 应 该 被 设置 为 tue。 诸如 Windows 之 类 的 操作 系统 只 允许 命令 行 最 多 输入 
8 191 个 字符 ;该 变量 通过 分 解构 建 命令 使 其 长 度 小 于 8 191 个 字符 。 在 较 小 的 模 
块 中 不 推荐 使 用 该 方法 ， 因 为 使 用 它 会 让 构建 过 程 变 慢 。 

e LOCAL_FILTER_ASM: 该 变量 定义 了 用 于 过 滤 来 自 LOCAL _SRC _FILES 变量 的 
装配 文件 的 应 用 程序 。 


9. 其 他 的 构建 系统 函数 宏 


本 节 概 括 了 Android NDK 构建 系统 支持 的 其 他 函数 宏 。 
e all-subdir-makefiles: 返回 当前 目录 的 所 有 子 目录 下 的 Android.mk 构建 文件 列表 。 
例如 ， 调 用 以 下 命令 可 以 将 子 目 录 下 的 所 有 Android.mk 文件 包含 在 构建 过 程 中 : 


include $ (call all-subdir-makefiles) 


。 this-makefile: 返回 当前 Android.mk 构建 文件 的 路 径 。 
e parent-makefile: 返回 包含 当前 构建 文件 的 父 Android.mk 构建 文件 的 路 径 。 
e grand-parent-makefile: 和 parent-makefile 一 样 但 用 于 祖父 目录 。 
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10. 定义 新 变量 


开发 人 员 可 以 定义 其 他 变量 来 简化 他 们 的 构建 文件 。 以 LOCAL 和 NDK _ 前 级 开头 的 
名 称 预 留 给 Android NDK 构建 系统 使 用 。 建 议 开发 人 员 定 义 的 变量 以 MY_ 开头， 如 程序 
清单 2-9 所 示 。 


程序 清单 2-9 ”表示 开发 人 员 定义 的 中 间 变 量 的 使 用 方法 的 Android.mk 文件 


MY SRC FILES := avilib.c Platform posix.c 
LOCAL SRC FILES := $ (addprefix avilib/, $(MY SRC FILES)) 


11. 条 件 操作 
Android.mk 构建 文件 也 可 以 包含 关于 这 些 变量 的 条 件 操作 ， 例 如 : 在 每 个 体系 结构 中 
包含 一 个 不 同 的 源 文件 集 ， 如 程序 清单 2-10 所 示 。 


程序 清单 2-10 ”包含 条 件 操作 的 构建 文件 Android.mk 


ifeq ($(TARGET ARCH) ,arm) 
LOCAL SRC FILES + = armonly.c 
else 
LOCAL SRC FILES + = generic.c 
endif 


2.4.2 Application.mk 


Application.mk 是 Android NDK 构建 系统 使 用 的 一 个 可 选 构建 文件 。 和 Android.mk 文 
件 一 样 ， 它 也 被 放 在 jni 目录 下 。Application.mk 也 是 一 个 GUN Makefile 片段 。 它 的 目的 
是 描述 应 用 程序 需要 哪些 模块 ; 它 也 定义 所 有 模块 的 通用 变量 。 以 下 是 Application.mk 构 
建文 件 支 持 的 变量 : 

e APP MODULES: 默认 情况 下 ，Android NDK 构建 系统 构建 Android.mk 文件 声明 
的 所 有 模块 。 该 变量 可 以 覆盖 上 述 行为 并 提供 一 个 用 空格 分 开 的 、 需 要 被 构建 的 
模块 列表 。 

e APP_OPTIM: 该 变量 可 以 被 设置 为 release 或 debug 以 改变 生成 的 二 进 制 文件 的 
优化 级 别 。 默 认 情 况 下 使 用 的 是 release 模式 ， 并 且 此 时 生成 的 二 进 制 文件 被 高 度 
优化 。 该 变量 可 以 被 设置 为 debug 模式 以 生成 更 容易 调试 的 未 优化 二 进 制 文件 。 

。 APP_CLAGS: 该 变量 列 出 了 一 些 编译 器 标志 ， 在 编译 任何 模块 的 C 和 C++ 源 文 
件 时 这 些 标 志 都 会 被 传 给 编译 器 。 

。 APP_CPPFLAGS: 该 变量 列 出 了 一 些 编译 器 标志 ， 在 编译 任何 模块 的 C++ 源 文件 
时 这 些 标志 都 会 被 传 给 编译 器 。 
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2.5 


APP_BUILD_SCRIPT: 默认 情况 下 ，Android NDK 构建 系统 在 项 目的 jni 子 目录 
下 查找 Android.mk 构建 文件 。 可 以 用 该 变量 改变 上 述 行 为 ， 并 使 用 不 同 的 生成 
文件 。 

APP_ABI: 默认 情况 下 , Android NDK 构建 系统 为 armeabi ABI 生成 二 进 制 文件 。 
可 以 用 该 变量 改变 上 述 行为 ， 并 为 其 他 ABI 生成 二 进 制 文件 ， 例 如 : 

APP ABI := mips 

另外 ， 可 以 设置 多 个 ABI 


APP ABI := armeabi mips 


为 所 有 支持 的 ABI 生成 二 进 制 文件 
APP ABI := all 


APP_STL: 默认 情况 下 ，Android NDK 构建 系统 使 用 最 小 STL 运行 库 ， 也 被 称 为 
system 库 。 可 以 用 该 变量 选择 不 同 的 STL 实现 。 

APP_STL :=stlport shared 

APP_GNUSTL_FORCE_CPP_FEATURES: 与 LOCAL CPP_EXTENSIONS 变量 
相似 ， 该 变量 表明 所 有 模块 都 依赖 于 具体 的 C++ 特性 ， 如 RTTI、exceptions 等 。 
APP_SHORT_COMMANDS: 与 LOCAL SHORT_COMMANDS 变量 相似 ， 该 变 
量 使 得 构建 系统 在 有 大 量 源 文件 的 情况 下 可 以 在 项 目 中 使 用 更 短 的 命令 。 


使 用 NDK-Build 脚本 


如 前 所 述 ， 可 以 通过 执行 ndk-build 脚本 启动 Android NDK 构建 系统 。 该 脚本 用 一 组 
参数 使 维护 和 控制 构建 过 程 更 容易 。 
。 默认 情况 下 ，ndk-build 脚本 应 该 在 主 项 目 目录 中 执行 。-C 参数 可 以 用 于 指定 命令 


行 中 NDK 项 目的 位 置 ， 这 样 一 来 ndk-build 脚本 可 以 从 任意 的 位 置 开始 。 
ndk-build -C /path/to/the/project 


如 果 源 文件 没 被 修改 ，Android NDK 构建 系统 不 会 重 构建 目标 。 可 以 用 -B 执行 
ndk-build 脚本 来 强制 重 构建 所 有 源 代码 。 


ndk-build -B 


为 了 清理 生成 的 二 进 制 文件 和 目标 文件 ， 可 以 在 命令 行 执行 ndk-build clean 命令 。 
Android NDK 构建 系统 会 删除 生成 的 二 进 制 文件 。 


ndk-build clean 


Android NDK 构建 系统 依赖 于 GNU Make 工具 对 模块 进行 构建 ,默认 情况 下 , GNU 
Make 工具 一 次 执行 一 句 构建 命令 ， 等 这 一 句 完成 以 后 再 执行 下 一 句 。 如 果 在 命令 
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行使 用 -j 参数 ，GNU Make 就 可 以 并 行 执行 构建 命令 。 另 外 ， 也 可 以 通过 指定 该 参 
数 之 后 的 数字 来 指定 并 行 执行 的 命令 总 数 。 


ndk-build - 4 


2.6 ”排除 构建 系统 故障 


Android NDK 构建 系统 有 大 量 的 日 志 以 支持 构建 系统 相关 的 故障 排除 ， 本 节 将 简要 阐 
述 构建 系统 故障 排除 。 

在 命令 行 输入 ndk-build NDK_LOG=1 便 可 启用 Android NDK 构建 系统 内 部 状态 日 志 
功能 。Android NDK 构建 系统 会 产生 大 量 的 日 志 ， 日 志 消息 的 前 缀 是 Android NDK( 如 
图 2-13 所 示 )。 


I 


TT CNwindows\system 


3Zvemd exe - ndk-build NDK_LOG=1 西 回 四 


:\android\workspace\com.exanple.hellojni.HelloJni>ndk-build NDK_LOG=1 
Android NDK: NDK installation path auto-detected: ’C:/android/android-ndk-—r8’ 
Android NDK: GNU Make version 3.81 detected 

Android NDK: Host 0S was auto-detected: windows | 
Android NDK: Host operating systen detected: windows | 
Android NDK: Host CPU was auto-detected: x86 | 
Android NDK: HOST_TAG set to windows 

Android NDK: Host tools prebuilt directory: C:/android/android-ndk-r8/prebuilt/w 


Android NDK: Host ’echo’ tool: C:/android/android-ndk-r8/prebuilt/windows/hin/ec 
ndroid NDK: Host ’awk’ tool: C:/android/android-ndk-r8/prebuilt/windows/bin/awk 


: Host ’awk’ test returned: Pa 
;This NDK supports the fo}loving target architectures and ABIS: | 
:arn: arneal 


时 ls 


图 2-13 ndk-build 脚本 显示 调试 信息 


如 果 只 想 看 实际 执行 的 构建 命令 ， 可 以 在 命令 行 输入 ndk-build V=1。Android NDK 将 
会 只 显示 构建 命令 ， 如 图 2-14 所 示 。 


mn cspaceNcom- exanple. | oJ Ak- 
ar Tinwe androideab 4: 3] a 
\libs\arneabi" nd ".\libs\arneabi" 
id\android-ndk-r8\toolchains\arn-linux-androideabi-4.4.3\preb 
\libs\arneabi\gdbserver” > NUL 
libs/arneabi/gdb.setu 
.\ibs\arneabi” nd “.\libs\arneabi" 
:/android/android-ndk-r8/prebuilt/windows/bin/echo.exe "set solib-search-path - 
‘obhj/local/arneabi" > ./libs/arneabi/gdb.setup 


:/android/android-ndk-r8/prebuilt/windows/bin/echo.exe "directory C:/android/an 
droid-ndk-—r8/platforns/android-14/arch-arn/usr/include jni C:/android/android-—nd 
/COE >> ./libs/arneabi/gdb.setup 
lo-jni => libs/armeabi/hellosini 
al 


if not exist dai md 
\libs\arneabi\hello-jni” > NUL 
inux-androideabi-4.4.3/prebuilt/window 
EE/bin/arm-linux-androideabi-strip 一 strip-unneeded ./libs/armneabi/hello-jni 


:\android\workspace\con.exanple.hellojni.HelloJni> | 


图 2-14 ndk-build 脚本 显示 构建 命令 
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2.7 小 结 


本 章 引导 读者 学 习 了 在 Eclipse IDE 环境 下 构建 NDK 项 目的 方法 , 在 此 过 程 中 讲述 了 
很 多 Android NDK 构建 系统 的 知识 ,第 3 章 将 继续 学 习 用 Android NDK 构建 的 原生 组 件 如 
何 与 实际 的 Java 应 用 程序 通信 。 


第 


山 


用 JNI 实现 与 原生 代码 通信 


第 2 章 通过 学 习 Android NDK 的 组 件 、 结 构 和 构建 系统 对 Android NDK 有 了 初步 的 了 
解 ， 现 在 可 以 构建 任何 一 段 原生 代码 并 将 其 与 Android 应 用 一 起 打包 。 本 章 将 集中 讨论 使 
用 Java 原生 接口 (JNI，Java Native Interface) 技 术 实 现 Java 应 用 程序 和 原生 代码 之 间 通 信 。 


3.1 什么 是 JNI 


JNI 是 Java 程序 设计 语言 功能 最 强 的 特征 ， 它 允许 Java 类 的 某 些 方法 原生 实现 ， 同 
时 让 它们 能 够 像 普 通 Java 方法 一 样 被 调用 和 使 用 。 这 些 原生 方法 也 可 以 使 用 Java 对 象 ， 
使 用 方法 与 Java 代码 使 用 Java 对 象 的 方法 相同 。 原 生 方 法 可 以 创建 新 的 Java 对 象 或 者 使 
用 Java 应 用 程序 创建 的 对 象 ， 这 些 Java 应 用 程序 可 以 检查 、 修 改 和 调用 这 些 对 象 的 方法 
以 执行 任务 。 


3.2 ”以 一 个 示例 开始 


在 详细 讲解 JNI 技术 之 前 , 我 们 先 看 一 个 示例 应 用 程序 。 这 会 为 本 章 的 概念 学 习 和 API 
实验 提供 必要 的 基础 。 学 习 了 这 个 示例 应 用 程序 之 后 ， 我 们 将 会 掌握 以 下 主要 概念 : 

e Java 代码 如 何 调用 原生 方法 

e 声明 原生 方法 

。 在 共享 库 中 载 入 原生 模块 

e 在 C/C++ 中 实现 原生 方法 

首先 ， 打 开 Eclipse 集成 开发 环境 ， 进 入 第 2 章 引 入 的 hello-jni 示例 项 目 。hello-jni 应 
用 程序 是 单个 活跃 的 Android 应 用 程序 。 在 Project Explorer 视图 中 展开 src 目录 ， 再 展开 
com.example.hellojni 包 。 双 击 HelloJni.java 源 文件 在 Editor 视图 中 打开 HelloJni activity。 

helloJni activity 有 一 个 由 单个 android.widget.TextView widget 构成 的 很 简单 的 用 户 接 
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口 。 在 activity 的 onCreate 方法 体 中 ，TextView widget 的 字符 串 值 被 设置 成 stringFromJNI 
方法 的 返回 值 ， 如 程序 清单 3-1 所 示 。 


程序 清单 3-1 HelloJni Activity onCreate Method 
/xx 当 activity 首次 创建 时 调用 . */ 
override 


public void onCreate (Bundle savedInstanceState) 
{ 


super.onCreate (savedInstanceState); 
/* 创建 一 个 文本 视图 并 设置 其 内 容 

* 通过 调用 一 个 原生 函数 检索 文本 

4 

TextView tv = new TextView (this); 
tv.setText( stringFromJNI() ); 


setContentView (tv); 
} 


这 里 没有 什么 新 内 容 ， 在 onCreate 方法 的 下 面 可 以 看 到 stringFromJNI 方法 。 
3.2.1 原生 方法 的 声明 


如 程序 清单 3-2 所 示 , stringFromJNI 方 法 声明 中 含有 关键 字 native 以 通知 Java 编译 器 ， 
它 用 另 一 种 语言 提供 该 方法 的 具体 实现 。 因 为 原生 方法 没有 方法 体 ， 方 法 声明 以 语句 终结 
符 一 一 分 号 结尾 。 

程序 清单 3-2 原生 stringFromJNI 方法 的 方法 声明 

/* 原生 方法 由 'hel1o-jni' 原 生 库 实现 

* "hello-jni"， 该 原生 库 与 本 应 用 程序 一 起 打包 

4 
public native String StringFromJNI() 7 


尽管 现在 虚拟 机 知道 该 方法 被 原生 实现 ， 但 是 它 仍然 不 知道 到 哪儿 去 找 方 法 的 实现 。 
3.2.2 ”加 载 共 享 库 


第 2 章 提 到 ， 原 生 方法 被 编译 成 一 个 共享 库 。 需 要 先 加 载 该 共享 库 以 便于 虚拟 机 能 够 
找到 原生 方法 实现 。java.lang.System 类 提供 了 两 个 静态 方法 ，load 和 loadLibrary， 用 于 在 
运行 时 加 载 共 享 库 。 如 程序 清单 3-3 所 示 ，HelloJni activity 加 载 hello-jni 共享 库 。 


程序 清单 3-3 ”HelloJni Activity 加 载 hello-jni 共享 库 


/* 这 段 代码 用 于 在 应 用 启动 时 加 载 'hello-jni' 库 

* 该 库 在 安装 时 由 包 管 理 器 

* 解压 到 /data/data/com.example.HelloJni/lib/libhello-jni.so 中 
wk 
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static { 
System.loadLibrary ("hello-jni"); 
} 


因为 想 加 载 原 生 代码 实现 ， 正 如 类 首次 加 载 和 初始 化 一 样 ， 所 以 在 静态 上 下 文中 调用 
loadLibrary 方法 。 

请 记 住 ，Java 技术 的 设计 目标 是 平台 独立 ， 作 为 Java 框架 API 的 一 部 分 ，loadLibrary 
也 要 保持 平台 独立 性 。 尽 管 Android NDK 生成 的 实际 共享 库 被 命名 为 libhello-jni.so， 但 是 
loadLibrary 方法 只 采用 hello-jni 这 个 库 名 ， 再 按照 所 使 用 的 具体 操作 系统 的 要 求 加 上 必要 
的 前 级 或 后 级 。 库 名 与 Android.mk 文件 中 使 用 LOCAL MODULE 构建 系统 变量 定义 的 模 
块 名 相同 。 

loadLibrary 的 参数 也 不 包含 共享 库 的 位 置 。Java 库 路 径 ， 也 就 是 系统 属性 java.library. 
path 保存 loadLibrary 方法 在 共享 库 搜索 的 目录 列表 ，Android 上 的 Java 库 路 径 包含 /vendorlib 
和 /systenylib。 

需要 强调 的 是 ，loadLibrary 在 扫描 Java 库 路 径 时 ， 一 旦 发 现 同名 的 库 ， 立 即 加 载 共 享 
库 。 因 为 Java 库 路 径 的 第 一 组 目录 是 Android 系统 目录 ， 为 了 避免 与 系统 库 命名 冲突 ， 强 
烈 建 议 Android 开发 人 员 为 每 个 共享 库 选择 唯一 的 名 字 。 

现在 我 们 看 看 原生 代码 ， 学 习 原 生 方 法 的 声明 和 实现 方法 。 


3.2.3 ”实现 原生 方法 


在 Project Explorer 视图 中 , 展开 jni 目录 并 双击 hello-jni.c 源 文件 在 Editor 视图 中 打开 
该 文件 。 如 程序 清单 3-4 所 示 ，C 源 代码 文件 以 jni.h 头 文件 包含 语句 开头 ， 这 个 头 文件 中 
包含 INI 数据 类 型 和 函数 的 定义 。 


程序 清单 3-4 ”stringFromJNI 方法 的 原生 实现 


#include <string.h> 
#include <jni.h> 


ote 
Java_com example hellojni HelloJni stringFromJNI( JNIEnv* enV， 
jobject thiz ) 
{ 
return (*env)->NewStringUTF (env, "Hello from JNI !"); 

} 

原生 方法 stringFromJNI 也 用 一 个 名 为 Java_com_example_hellojni_HelloJni_stringFromJNI 
的 完全 限定 的 函数 来 声明 ， 这 种 显 式 的 函数 命名 让 虚拟 机 在 加 载 的 共享 库 中 自动 查找 原生 
函数 。 

1. C/C++ 头 文件 生成 器 : javah 


让 原生 函数 名 及 参数 列表 与 Java 类 文件 的 原始 定义 一 致 是 繁杂 而 多 余 的 ， 因 为 IDK 
自 带 一 个 名 为 javah 的 命令 行 工具 来 执行 任务 , javah 工具 可 以 为 原生 方法 解析 Java 类 文件 
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并 生成 由 原生 方法 声明 组 成 的 头 文件 。 


(1) 在 命令 行 方式 下 运行 

在 命令 行 方式 下 ,将 当前 工作 目录 改 为 HelloJni 项 目的 导入 目录 , 即 <Eclipse Workspace> 
/com.example.hellojni.HelloJni。javah 工具 对 编译 过 的 Java 类 文件 进行 操作 ， 用 编译 过 的 类 
文件 所 在 位 置 和 要 解析 的 Java 类 名 为 参数 调用 javah， 命 令 格式 如 下 : 


javah -classpath bin/classes com.example.hellojni.HelloJni 


javah 工具 将 解析 com.example.hellojni.HelloJni 类 文件 , 且 生 成 名 为 com_example_hellojni_ 
HelloJni.h 的 C/C++ 头 文件 ， 文 件 内 容 如 程序 清单 3-5 所 示 。 


程序 清单 3-5 ” 头 文件 com_example_hellojni_HelloJni.h 
/* 不 要 编辑 这 个 文件 - 它 是 机 器 自动 生成 的 */ 


#include < jni.h> 
/* com example hellojni HelloJni 类 的 头 文件 */ 


#ifndef _Included com example hellojni HelloyJni 
#define _Included com example hellojni HelloyJni 
#ifdef _cplusplus 
extern "CcC" { 
#endif 
/* 
* Class: com example hellojni HelloJni 
* Method: stringFromJNI 
* Signature: ()Ljava/lang/string; 
wy 
JNIEXPORT jstring JNICALL Java com example hellojni HelloJni stringFromJNI 
(UNIEnV *, jobject); 
/* 
* Class: com example hellojni HelloyJni 
* Method: unimplementedSstringFromJNI 
* Signature: ()Ljava/lang/string; 
np 
JNIEXPORT jstring JNICALL Java com example hellojni HelloJni_ 
unimplementedSstringFromJNI 
(JNIEnvV *, jobject); 


#ifdef _ cplusplus 
} 

#endif 

#endif 


C/C++ 源 文件 只 需要 包含 这 个 头 文件 并 提供 原生 方法 的 实现 ， 如 程序 清单 3-6 所 示 。 


程序 清单 3-6 ”com_example_hellojni_HelloJni.c 源 文件 


#include "com example hellojni HelloJni.h” 
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JNIEXPORT jstring JNICALL Java com _ example _ hellojni HelloJni stringFromJNI 
(UNIEnV * env, jobject thiz) 

{ 
return (*env)->NewStringUTF (env, "Hello from JNI !"); 


} 


并 不 需要 每 次 都 在 命令 行 方 式 下 运行 javah 工具 ， 为 了 简化 头 文件 生成 的 过 程 ， 它 可 
以 被 集成 到 Eclipse 中 成 为 Eclipse 的 外 部 工具 。 


(2) 在 Eclipse IDE 中 运行 

打开 Eclipse IDE, 在 顶部 菜单 栏 选 择 Run | External Tools External Tools Configurations 。 
在 External Tools Configurations 对 话 框 中 选择 Program, 单 击 New launch configuration 按钮 ， 
单 击 Main 选项 不， 如 图 3-1 所 示 ， 按 照 下 面 的 内 容 填写 工具 信息 : 
Name: Generate C and C++ Header File 
Location: ${system path:javah} 
Working Directory: ${project loc}/jni 
Arguments: -classpath "${project classpath};$ {env_var:ANDROID SDK HOME}/ 
platforms/android-14/android.jar" $ {java_type_name} 


Etemal Tools Configurations 


Create. manage. and run configurations 
Run a program 


| 有 XI 日 各 NomelGeneaeCandCrheaderfie | 

Peertea ] | ET Refresh 局 Bad] Ervironment| © Common| 
业 Ant Build 

~ APl Use Report 


日 Program 
ee 


-Arguments: 
espe PRED OREO /putforms /onckoid-14/android jar” 


Note: Enclose an argument containing spaces using double -quotes ("). 


[Cox ][ sw |] 
CE | 


图 3-1 javah 外 部 工具 配置 


在 MacOSX 和 Linux 平台 上 需要 冒号 代替 分 号 。 切换 到 Refresh 选项 卡 , 选中 Refresh 
resource Upon completion 复 选 框 ， 并 在 列表 中 选择 The project containing the selected 
resource， 如 图 3-2 所 示 。 
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多 Etemal Tools Configurations 


Create. manage. and run configurations 
Run a program 


区 上 | 日 癌 - 


Name: [Generate Cand C+ Header Fie ] 
ype filter text | E -Build| 丁 Environment | 器 Common | 
一 案 Ant Build 

一 @ API Use Report 


日 Program o 
Generae C =n] ||| Ore 
O Speciic resources 


同 Recursively include subfolders 


图 3-2 运行 javah 工具 时 刷新 项 目 


切换 到 Common 选项 卡 ， 选 中 Display in favorites menu 组 下 面 的 复 选 框 External Tools， 
如 图 3-3 所 示 。 


Peerted | 
汪 Ant Build 
“~@ APl Use Report 


日 Program 
Nenerate Cand 


© Defauh -inherited (Cp1252) 


Oomerlsoss551 [| 


3-3 ”在 收藏 夹 菜 单 中 显示 javah 工具 


单 击 OK 按钮 保存 外 部 工具 配置 。 为 了 测试 配置 的 效果 ， 在 Project Explorer 视图 中 选 
择 HelloJni 类 ， 选 择 Run | External Tools | Generate C and C++ Header File，javah 工具 将 为 
原生 方法 解析 选中 的 类 文件 ,并 在 jni 目录 下 生成 一 个 名 为 com_example_hellojni_HelloJnih 
的 、 带 有 方法 描述 的 C/C++ 头 文件 。 

既然 你 已 经 掌握 了 自动 生成 原生 方法 声明 的 方法 ， 下 面 我 们 详细 介绍 生成 的 方法 
声明 。 

2. 方法 声明 


尽管 Java 方法 stringFromJNI 不 带 任何 参数 ， 但 是 原生 方法 带 两 个 参数 ， 如 程序 清 
单 3-7 所 示 。 
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程序 清单 3-7 ”原生 方法 的 强制 参数 
JNIEXPORT jstring JNICALL 
Java com example hellojni HelloJni stringFromJNI (JNIEnv *, jobject); 
第 一 个 参数 JNIEnv 是 指向 可 用 JNI 函数 表 的 接口 指针 ; 第 二 个 参数 jobject 是 HelloJni 
类 实例 的 Java 对 象 引用 。 


(1) JNIEnv 接口 指针 

原生 代码 通过 JNIEnv 接口 指针 提供 的 各 种 函数 来 使 用 虚拟 机 的 功能 。JNIEnv 是 一 个 
指向 线程 -局 部 数据 的 指针 ， 而 线程 -局 部 数据 中 包含 指向 函数 表 的 指针 。 实 现 原生 方法 的 
函数 将 INIEnv 接口 指针 作为 它们 的 第 一 个 参数 。 


注意 
传递 给 每 一 个 原生 方法 调用 的 JNIEnv 接口 指针 在 与 方法 调用 相关 的 线程 中 也 有 效 ， 
但 是 它 不 能 被 缓存 以 及 被 其 他 线程 使 用 。 


原生 代码 是 C 与 原生 代码 是 C++ 其 调用 JNI 函数 的 语法 不 同 。C 代码 中 , JNIEnv 是 指 
向 JNINativeInterface 结构 的 指针 , 为 了 访问 任何 一 个 JNI 函数 , 该 指针 需要 首先 被 解 引用 。 
因为 C 代码 中 的 JNI 函数 不 了 解 当前 的 JNI 环境 , JNIEnv 实例 应 该 作为 第 一 个 参数 传递 给 
每 一 个 JNI 函数 调用 调用 者 ， 调 用 格式 如 下 : 


return (*envV) ->NewStringUTF (env, "Hello from JNI !"); 


在 C++ 代码 中 ，JNIEnv 实际 上 是 C++ 类 实例 ，JNI 函数 以 成 员 函 数 的 形式 存在 。 因 为 
JNI 方法 已 经 访问 了 当前 的 JNI 环境 ， 因 此 JNI 方法 调用 不 要 求 INIEnv 实例 作 参 数 。 在 
C++ 中 ， 完 成 同样 功能 的 调用 代码 格式 如 下 : 


return enV->NewStringUTE ("Hello from JNI !"); 


(2) 实例 方法 与 静态 方法 

Java 程序 设计 语言 有 两 类 方法 :实例 方法 和 静态 方法 。 实 例 方法 与 类 实例 相关 ， 它 们 
只 能 在 类 实例 中 调用 。 静 态 方法 不 与 类 实例 相关 ， 它 们 可 以 在 静态 上 下 文 直接 调用 。 静 态 
方法 和 实例 方法 均 可 以 声明 为 原生 的 ， 可 以 通过 JNI 技术 以 原生 代码 的 形式 提供 它们 的 实 
现 。 原生 实例 方法 通过 第 二 个 参数 获取 实例 引用 , 该 参数 是 jobject 类 型 的 , 如 程序 清单 3-8 
所 示 。 


程序 清单 3-8 ”原生 实例 方法 定义 


JNIEXPORT jstring JNICALL Java com example hellojni HelloJni stringFromJNI 

(JNIEnV * env, jobject thiz); 

因为 静态 方法 没有 与 实例 绑 定 ， 因 此 通过 第 二 个 参数 获取 类 引用 而 不 是 实例 引用 ， 第 
二 个 参数 是 jclass 值 类 型 的 ， 如 程序 清单 3-9 所 示 。 
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程序 清单 3-9 ”原生 静态 方法 定义 
JNIEXPORT jstring JNICALL 
Java com example hellojni HelloJni stringFromJNI (JNIEnv * env, jclass clazz); 


正如 在 方法 定义 中 看 到 的 ，JNI 提供 了 自己 的 数据 类 型 从 而 让 原生 代码 了 解 Java 数据 
类 型 。 


3.3 数据 类 型 


Java 中 有 两 种 数据 类 型 : 

e 基本 数据 类 型 :布尔 型 、 字 节 型 、 字 符 型 、 短 整 型 、 整 型 、 长 整 型 、 浮 点 型 和 双 
精度 类 型 。 

e 引用 类 型 : 字符 串 类 、 数 组 类 及 其 他 类 。 

我 们 将 进一步 学 习 每 种 数据 类 型 。 


3.3.1 基本 数据 类 型 


基本 数据 类 型 可 以 直接 与 C/C++ 的 相应 基本 数据 类 型 映射 ， 如 表 3-1 所 示 。JNI 用 类 
型 定义 使 得 这 种 映射 对 开发 人 员 透 明 。 


表 3-1 Java 基本 数据 类 型 


Java 类 型 “| JN 并 | cer 并 | 大 小 
Boolean | maom | wienedchr | 天 符号 s 位 
Byte 有 符号 8 位 
Char 无 符号 16 位 
Short 有 符号 16 位 
Int 有 符号 32 位 
Long g 有 符号 64 位 
Float 32 位 
Double 位 

3.3.2 引用 类 型 


与 基本 数据 类 型 不 同 ， 引 用 类 型 对 原生 方法 是 不 透明 的 ， 引 用 类 型 映射 如 表 3-2 所 示 。 
它们 的 内 部 数据 结构 并 不 直接 向 原生 代码 公开 。 
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表 3-2 Java 引用 类 型 映射 


Java 类 型 原生 类 型 
java.lang.Class jclass 
java.lang. Throwable jthrowable 
java.lang. String jstring 
Other objects jobjects 
java.lang.Object[] jobjectArray 
boolean jbooleanArra 
bytel jbyteArra 
char| jcharArra' 
Short jshortArra 
int| jintArra. 
long jlongArra 
float jnoatArmra 
double| jdoubleArra 
Other arrays Jarra' 


3.4 对 引用 数据 类 型 的 操作 


引用 类 型 以 不 透明 的 引用 方式 传递 给 原生 代码 ， 而 不 是 以 原生 数据 类 型 的 形式 呈现 ， 
因此 引用 类 型 不 能 直接 使 用 和 修改 。 JNI 提供 了 与 这 些 引 用 类 型 密切 相关 的 一 组 API， 这 
些 API 通过 JNIEnv 接口 指针 提供 给 原生 函数 。 本 节 将 简单 介绍 与 下 列 类 型 和 组 件 相 关 


的 API: 

字符 串 
数组 

NIO 缓冲 区 
字段 

方法 


3.4.1 字符 串 操作 


JNI 把 Java 字符 串 当成 引用 类 型 来 处 理 。 这 些 引 用 类 型 并 不 像 原生 C 字符 串 一 样 可 以 
直接 使 用 , JNI 提供 了 Java 字符 串 与 C 字符 串 之 间 相互 转换 的 必要 函数 。 因 为 Java 字符 串 
对 象 是 不 可 变 的 ， 因 此 JNI 不 提供 任何 修改 现 有 的 Java 字符 串 内 容 的 函数 。 

JNI 支持 Unicode 编码 格式 和 UTF-8 编码 格式 的 字符 串 , 还 提供 两 组 函数 通过 JNIEnv 


接口 指针 处 理 这 些 字符 串 编码 。 
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1. 创建 字符 串 


可 以 在 原生 代码 中 用 NewString 函数 构建 Unicode 编码 格式 的 字符 串 实例 ， 用 
NewStringUTF 函数 构建 UTF-8 编码 格式 的 字符 串 实 例 。 正 如 程序 清单 3-10 所 示 ， 这 些 函 
数 以 一 个 C 字符 串 为 参数 ， 并 返回 一 个 Java 字符 串 引 用 类 型 jstring 值 。 


程序 清单 3-10 ”用 给 定 的 C 字符 串 创 建 Java 字符 串 


jstring javastring; 
javastring = (*enV)->NewStringUTF (env, "Hello World!"); 


在 内 存 溢出 的 情况 下 ， 这 些 函 数 返回 NULL 以 通知 原生 代码 虚拟 机 中 抛 出 异常 ， 这 样 
原生 代码 就 会 停止 运行 ， 本 章 的 后 面 几 节 会 介绍 异常 处 理 相 关内 容 。 


2. 把 Java 字符 串 转 换 成 C 字符 串 


为 了 在 原生 代码 中 使 用 Java 字符 串 ， 需 要 先 将 Java 字符 串 转换 成 C 字符 串 。 用 
GetStringChars 函数 可 以 将 Unicode 格式 的 Java 字符 串 转换 成 C 字符 串 ， 用 GetString- 
UTFChars 函数 可 以 将 UTF-8 格式 的 Java 字符 串 转换 成 C 字符 串 。 这 些 函 数 的 第 三 个 参数 
均 为 可 选 参数 ， 该 可 选 参数 名 是 isCopy， 它 让 调用 者 确定 返回 的 C 字符 串 地 址 指向 副本 还 
是 指向 堆 中 的 固定 对 象 ， 如 程序 清单 3-11 所 示 。 


程序 清单 3-11 将 Java 字符 串 转换 成 C 字符 串 
Const jbyte* str; 


jboolean isCopy; 


str = (*env)->GetstringUTFChars (env, 
if {0 f= str) { 
printf ("Java string: %s", str); 


javastring, &isCopy); 


if (JNI_TRUE == isCopy) { 


printf("C string is a copy of the Java string."); 
} else { 


printf("C string points to actual string."); 
} 
} 


3. 释放 字符 串 
通过 JNI GetStringChars 函数 和 GetStringUTFChars 函数 获得 的 C 字符 串 在 原生 代码 中 


使 用 完 之 后 需要 正确 地 释放 ， 否 则 将 会 引起 内 存 泄露 。 如 程序 清单 3-12 所 示 ，JNI 提供 了 


ReleaseStringChars 函数 释放 Unicode 编码 格式 的 字符 串 , 而 用 ReleaseStringUTFChars 函数 
释放 UTF-8 编码 格式 的 字符 串 。 


程序 清单 3-12 ”释放 JNI 函数 返回 的 C 字符 串 
(*env) ->ReleaseStringUTFChars (env, javastring, 


str); 
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3.4.2 ”数组 操作 


JNI 把 Java 数组 当成 引用 类 型 来 处 理 ，JNI 提供 必要 的 函数 访问 和 处 理 Java 数组 。 
1. 创建 数组 


用 New<Type>Array 函数 在 原生 代码 中 创建 数组 实例 ， 其 中 <Type> 可 以 是 mt、Char 
和 Boolean 等 ， 例 如 NewIntArray。 如 程序 清单 3-13 所 示 ， 使 用 这 些 函数 时 应 该 以 参数 的 
形式 给 出 数组 大 小 。 


程序 清单 3-13 ”在 原生 代码 中 创建 数组 


jintArray javaRrray7 


javaArray = (*enV) ->NewIntRrray (env, 10); 
if (0 != javaArray) { 


/+ 现在 可 以 使 用 数组 了 */ 
} 


与 NewString 函数 一 样 ， 在 内 存 溢 出 的 情况 下 ，New<Type>Array 函数 将 返回 NULL 
以 通知 原生 代码 虚拟 机 中 有 异常 抛 出 ， 这 样 原生 代码 就 会 停止 运行 。 


2. 访问 数组 元 素 


JNI 提供 两 种 访问 Java 数组 元 素 的 方法 ， 可 以 将 数组 的 代码 复制 成 C 数组 或 者 让 JNI 
提供 直接 指向 数组 元 素 的 指针 。 
3. 对 副本 的 操作 


Get<Type>ArrayRegion 函数 将 给 定 的 基本 Java 数组 复制 到 给 定 的 C 数组 中 ， 如 程序 
清单 3-14 所 示 。 


程序 清单 3-14 ”将 Java 数组 区 复制 到 C 数组 中 
jint nativeArray[10]; 


(*env) ->GetIntArrayRegion(env, javaArray, 0, 10, nativeArray); 
原生 代码 可 以 像 使 用 普通 的 C 数组 一 样 使 用 和 修改 数组 元 素 。 当 原生 代码 想 将 所 做 的 


修改 提交 给 Java 数组 时 ， 可 以 使 用 Set<Type>ArrayRegion 函数 将 C 数组 复制 回 
中 ， 如 程序 清单 3-15 所 示 。 


Java 数组 


程序 清单 3-15 ”从 C 数组 向 Java 数组 提交 所 作 的 修改 


(*env) ->SetIntArrayRegion(env, javaArray, 0, 10, nativeArray); 


当 数 组 很 大 时 ， 为 了 对 数组 进行 操作 而 复制 数组 会 引起 性 能 问题 。 在 这 种 情况 下 ， 如 
果 可 能 的 话 ， 原 生 代码 应 该 只 获取 或 设置 数组 元 素 区 域 而 不 是 获取 整个 数组 。 另 外 ，JNI 
提供 了 不 同 的 函数 集 以 获得 数组 元 素 而 非 其 副本 的 直接 指针 。 
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4. 对 直接 指针 的 操作 


可 能 的 话 , 原生 代码 可 以 用 Get <Type>ArrayElements 函数 获取 指向 数组 元 素 的 直接 指 
针 。 如 程序 清单 3-16 所 示 ， 函 数 带 有 三 个 参数 ， 第 三 个 参数 是 可 选 参数 ， 该 可 选 参数 名 是 
isCopy， 让 调用 者 确定 返回 的 C 字符 串 地 址 指向 副本 还 是 指向 堆 中 的 固定 对 象 。 
程序 清单 3-16 ”获得 指向 Java 数组 元 素 的 直接 指针 


jint* nativeDirectArray; 
jboolean isCopy; 


nativeDirectArray = (*env)->GetIntArrayElements (env, javaArray, &isCopy); 
因为 可 以 像 普通 的 C 数组 一 样 访问 和 处 理 数组 元 素 ， 因 此 JNI 没 提供 访问 和 处 理 数 组 
元 素 的 方法 ，JNI 要 求 原生 代码 用 完 这 些 指针 立即 释放 ， 否 则 会 出 现 内 存 溢出 。 原 生 代码 
可 以 使 用 JNI 提供 的 Release<Type>ArrayElemens 函数 释放 Get<Type>ArrayElements 函数 
返回 的 C 数组 ， 如 程序 清单 3-17 所 示 。 
程序 清单 3-17 ”释放 指向 Java 数组 元 素 的 直接 指针 


(*env) ->ReleaseIntArrayElements (env, javaArray, nativeDirectArray, 0); 


该 函数 带 有 四 个 函数 ， 第 四 个 参数 是 释放 模式 ， 表 3-3 列 出 了 支持 的 释放 模式 列表 。 


表 3-3 支持 的 释放 模式 


释放 模式 动作 
0 将 内 容 复制 回来 并 释放 原生 数组 
JNI COMMIT 将 内 容 复 制 回 来 但 是 不 释放 原生 数组 ， 一 般 用 于 周期 性 地 更 新 一 个 Java 数组 
JNI_ABORT 释放 原生 数组 但 不 用 将 内 容 复制 回来 
3.4.3 NIO 操作 


原生 IO (NIO) 在 缓冲 管理 区 、 大 规模 网 络 和 文件 IO 及 字符 集 支持 方面 的 性 能 有 所 改 
进 。JNI 提供 了 在 原生 代码 中 使 用 NIO 的 函数 。 与 数组 操作 相 比 ，NIO 缓冲 区 的 数据 传送 
性 能 较 好 ， 更 适合 在 原生 代码 和 Java 应 用 程序 之 间 传送 大 量 数 据 。 


1. 创建 直接 字 节 缓冲 区 


原生 代码 可 以 创建 Java 应 用 程序 使 用 的 直接 字 节 缓冲 区 ,该 过 程 是 以 提供 一 个 原生 C 
字 节 数组 为 基础 ， 程 序 清单 3-18 中 列 出 了 NewDirectByteBuffer 的 使 用 。 


程序 清单 3-18 ”基于 给 定 的 C 字 节 数组 创建 字 节 缓冲 区 


unsigned char* buffer = (unsigned char*) malloc(1024) 7 
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jobject directBuffer; 
directBuffer = (*env)—->NewDirectByteBuffer (env, buffer, 1024); 


注意 

原生 方法 中 的 内 存 分 配 超出 了 虚拟 机 的 管理 范围 ， 且 不 能 用 虚拟 机 的 垃圾 回收 器 回收 
原生 方法 中 的 内 存 。 原 生 函 数 应 该 通过 释放 未 使 用 的 内 存 分 配 以 避免 内 存 泄 漏 来 正确 管理 
内 存 。 

2. 直接 字 节 缓冲 区 获取 

Java 应 用 程序 中 也 可 以 创建 直接 字 节 缓冲 区 , 在 原生 代码 中 调用 GetDirectBufferAddress 
函数 可 以 获得 原生 字 节 数组 的 内 存 地 址 ， 如 程序 清单 3-19 所 示 。 

程序 清单 3-19 通过 Java 字 节 缓冲 区 获取 原生 字 节 数组 

unsigned char* buffer; 


buffer = (unsigned char*) (*env)->GetDirectBufferAddress (env, 
directBuffer); 


3.4.4 ”访问 域 


Java 有 两 类 域 ， 实例 域 和 静态 域 。 类 的 每 个 实例 都 有 自己 的 实例 域 副本 ， 而 一 个 类 的 
所 有 实例 共享 同一 个 静态 域 。 

JNI 提供 了 访问 两 类 域 的 函数 ， 程 序 清单 3-20 显示 了 带 有 静态 域 和 实例 域 的 Java 类 
示例 。 

程序 清单 3-20” 带 有 静态 域 和 实例 域 的 Java 类 

public class JavaClass { 


/xx 实例 域 */ 


private String instanceField = "Instance Field"; 
/** 静态 域 */ 
private static String staticField = "Static Field"; 
} 
1. 获取 域 ID 


JNI 提供 了 用 域 ID 访问 两 类 域 的 方法 ， 可 以 通过 给 定 实例 的 class 对 象 获取 域 ID， 用 
GetObjectClass 函数 可 以 获得 class 对 象 ， 如 程序 清单 3-21 所 示 。 


程序 清单 3-21 用 对 象 引 用 获得 类 


jclass clazz; 
clazz = (*env)->GetObjectClass (env, instance); 
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有 两 个 获得 域 ID 的 函数 分 别 适 用 于 不 同类 型 域 ，GetFieldId 函数 用 于 获取 实例 域 ， 如 
程序 清单 3-22 所 示 。 
程序 清单 3-22 ”获取 实例 域 的 域 ID 


jfieldID instanceFieldId; 
instanceFieldId = (*env)->GetFieldID(env, clazz, "instanceField", 
"Ljava/lang/string; "); 


GetStaticFieldId 用 于 获取 静态 域 DD, 如 程序 清单 3-23 所 示 。 这 两 个 函数 均 返 回 jfieldD 
类 型 的 域 ID 。 
程序 清单 3-23 ”获得 静态 域 的 域 D 


jfieldID staticFieldId; 


staticFieldId = (*env)->GetStaticFieldIiD(env, clazz,"staticField", 
"Ljava/lang/string; "); 


两 个 函数 的 最 后 一 个 参数 是 Java 中 表示 域 类 型 的 域 描述 符 。 在 上 述 示例 代码 中 ， 
"Ljava/lang/String” 表 明 域 类 型 是 String， 本 章 后 面 的 内 容 将 会 再 次 探讨 这 个 问题 。 

小 贴 士 

为 了 提高 应 用 程序 的 性 能 ， 可 以 缓存 域 ID。 一 般 总 是 缓存 使 用 最 频繁 的 域 ID。 

2. 获取 域 


在 获得 域 ID 之 后 ， 可 以 用 Get<Tpe>Field 函数 获得 实际 的 实例 域 ， 如 程序 清单 3-24 
所 示 。 
程序 清单 3-24 ”获得 实例 域 


jstring instanceField; 
instanceField = (*env)->GetObjectField(env, instance, instanceFieldId); 


用 GetStatic<Type>Field 函数 获得 静态 域 ， 如 程序 清单 3-25 所 示 。 
程序 清单 3-25 ”获得 静态 域 


jstring staticField; 
staticField = (*env)->GetStaticObjectField(env, clazz, staticFieldId); 


在 内 存 溢出 的 情况 下 ， 这 些 函 数 均 返 回 NULL， 此 时 原生 代码 不 会 继续 执行 。 
小 贴 士 
获得 单个 域 值 需要 调用 两 到 三 个 JNI 函数 ,原生 代码 回 到 Java 中 获取 每 个 单独 的 域 值 ， 


这 给 应 用 程序 增加 了 人 额外 的 负担 ， 进 而 导致 性 能 下 降 。 强 烈 建议 将 所 有 需要 的 参数 传递 给 
原生 方法 调用 ， 而 不 是 让 原生 代码 回 到 Java 中 。 
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3.4.5 ”调用 方法 


与 域 一 样 ，Java 中 有 两 类 方法 : 实例 方法 和 静态 方法 。JNI 提供 访问 两 类 方法 的 函数 ， 
程序 清单 3-26 给 出 了 含有 一 个 静态 方法 和 一 个 实例 方法 的 Java 类 。 


程序 清单 3-26” 带 有 静态 方法 和 实例 方法 的 Java 类 


public class JavaClass { 
/* 太 


* 实例 方法 . 
Ey 
private String instanceMethod() { 


return "Instance Method"; 
下 


A 


* 静态 方法 . 
et 


private static String staticMethod() { 
return "Static Method"; 
} 


} 
1. 获取 方法 ID 


JNI 提 供 了 用 方法 功 访问 两 类 方法 的 途径 ,可 以 用 给 定 实例 的 class 对 象 获得 方法 人 D。 
用 GetMethodID 函数 获得 实例 方法 的 方法 下， 如 程序 清单 3-27 所 示 。 


程序 清单 3-27 ”获得 实例 方法 的 方法 ID 
jmethodID instanceMethodId; 


instanceMethodId = (*enV) ->GetMethodID (env, clazz, 
"instanceMethod", "()Ljava/lang/string;"); 
用 GetStaticMethodID 函数 获得 静态 域 的 方法 ID， 如 程序 清单 3-28 所 示 。 两 个 函数 均 
返回 jmethodID 类 型 的 方法 ID。 
程序 清单 3-28 ”获得 静态 方法 的 方法 ID 


jmethodID staticMethodId; 


staticMethodId = (*env)->GetstaticMethodID(env, clazz, 
"staticMethod", "()Ljava/lang/string;"); 


与 字段 ID 获取 方法 一 样 ， 两 个 函数 的 最 后 一 个 参数 均 表示 方法 描述 符 ， 在 Java 中 它 
表示 方法 签名 。 
小 贴 士 


为 了 提升 应 用 程序 的 性 能 ， 可 以 缓存 方法 ID。 一 般 总 是 缓存 使 用 最 频繁 的 方法 ID。 
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2. 调用 方法 
可 以 以 方法 ID 为 参数 通过 Call<Type>Method 类 函数 调用 实际 的 实例 方法 ， 如 程序 清 


单 3-29 所 示 。 


程序 清单 3-29 ”调用 实例 方法 


jstring instanceMethodResult; 
instanceMethodResult = (*env)->CallstringMethod (env, 
instance, instanceMethodId); 


用 CallStatic<Type>Field 类 函数 调用 静态 方法 ， 如 程序 清单 3-30 所 示 。 


程序 清单 3-30 ”调用 静态 方法 


jstring staticMethodResult; 
staticMethodResult = (*env)->CallstaticstringMethod (enyv, 
clazz, staticMethodId); 


在 内 存 溢出 的 情况 下 ， 这 些 函 数 均 返 回 NULL， 此 时 原生 代码 不 会 继续 执行 。 


小 贴 士 
Java 和 原生 代码 之 间 的 转换 是 代价 较 大 的 操作 , 强烈 建议 规划 Java 代码 和 原生 代码 的 


任务 时 考虑 这 种 代价 ， 最 小 化 这 种 转换 可 以 大 大 提高 应 用 程序 的 性 能 。 


3.4.6” 域 和 方法 描述 符 


正如 前 面 几 节 所 提 到 的 ， 获 取 域 ID 和 方法 DD 均 分 别 需 要 域 描述 符 和 方法 描述 符 ， 域 


描述 符 和 方法 描述 符 均 可 以 通过 表 3-4 的 Java 类 型 签名 映射 获得 。 


表 3-4 Java 类 型 签名 映射 
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Java 类 型 签名 
Boolean Zz 
Byte B 
Char Cc 
Short S 
Int I 
Long 
Float F 
Double D 
fully-qualified-class Lfully-qualified-class: 
type[] [type 
method type (arg-typejret-type 
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用 类 型 签名 映射 手工 生成 域 和 方法 描述 符 并 让 它们 与 Java 代码 同步 是 一 件 非常 繁琐 
的 任务 。 


Java 类 文件 反 汇编 程序 : javap 


JDK 提供 的 命令 行 方式 下 的 Java 类 文件 反 汇编 程序 称 为 javap， 该 工具 可 以 从 编译 的 
类 文件 中 解压 缩 域 和 方法 描述 符 。 


1. 在 命令 行 方式 下 运行 

在 命令 行 方式 下 ， 将 <Eclipse Workspace>/com.example.hellojni. HelloJni 设置 为 当前 工 
作 目 录 ， 该 目录 是 引入 HelloJni 项 目的 地 方 。javap 工具 在 编译 的 Java 类 文件 上 操作 ， 它 
带 有 两 个 参数 ， 分 别 表示 编译 的 类 位 置 及 要 反 汇 编 的 Java 类 名 字 ， 格 式 如 下 : 


javap -classpath bin/classes -p -s com.example.hellojni.HelloJni 


javap 工具 将 对 com.example.hellojni.HelloJni 类 文件 进行 反 汇 编 并 输出 图 3-4 所 示 的 域 
或 方法 签名 。 


s\android workspace on- Gxanple helloini.Hellodni>javap -classpath bin/classes 了 
p xanple .hellojni.HelloJni 

dnpi1ed ER PHeiloIn?. Javas 
p DY Cass con- exanple-heTlojni.HelloJni extends android.app.ActivityC 


:OU 

con.. ee -hellojni.HelloJniC); 

ature: 

void onCreateCandroid. > Bundle); 
: 《La le; 


:\android\workspace\con.exanple.hellojni.HelloJni> 


图 3-4 javap 工具 输出 


与 命令 行 方 式 每 次 都 运行 javap 工具 不 同 ，Eclipse 集成 开发 环境 中 将 javap 以 外 部 工 
具 的 形式 集成 在 Eclipse 中 以 方便 用 户 提取 域 和 方法 签名 。 


2. 在 Eclipse IDE 环境 下 运行 

打开 Eclipse 集成 开发 环境 ， 在 顶部 菜单 栏 中 选择 Run | External Tools Configurations..….， 
在 External Tools Configurations 对 话 框 中 选择 Program， 单 击 New launch configurations 按 
钮 。 选 中 Main 选项 卡 ， 如 图 3-5 所 示 ， 按 照 如 下 取 值 填 入 工具 信息 : 

e Name: Java Class File Disassembler 

e Location: ${system path:javap} 

® Working Directory: ${project loc} 

® Arguments: -classpath "${project classpath}:$ {env_var:ANDROID SDK HOMEY/ 

platforms/android-14/android.jar" -p —s $ {Java_type_name} 
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这 Etemal Tools Configurations 


Create. manage. and run configurations 
Run a program 


|| 划 厂 X| 日 厅 - 


个 TD SS Retresh| B Bald| 机 Evironment| 日 Common] 
[Location- 
[Stsystem pathjavap} 


Browse Workspace... | | Browse Fle System.. | | Variables... | 
「 Working Directory- 


1] 


Browse Workspace | | Bowse Rie System | | Variables.—- 


RE 


Arouments 


env yor ANDROID- SDK HOME)/platforms/android-14/android jar” -p = 
Stiava_type_name)| 


Note: Enclose an argument containing spaces using double-quotes (")- 


mT | | 
Cans J ss] 


图 3-5 javap 外 部 工具 配置 


在 Mac OSX 和 Linux 平台 上 ， 用 冒号 代替 分 号 。 切 换 到 Common 选项 卡 ， 像 前 面 介 
绍 过 的 一 样 ， 选 中 Display in favorites menu 组 下 面 的 复 选 框 External Tools。 

单 击 OK 按钮 保存 外 部 工具 配置 。 为 了 测试 新 配置 的 效果 ， 在 Project Explorer 视图 中 
选择 HelloJni 类 ， 然 后 选择 Run | External Tools | Java Class File Disassembler。 控 制 台 视 
图 将 显示 javah 工具 的 输出 ， 如 图 3-6 所 示 。 


oe i | console X | ropertes 下 其 浓 | 芭 加 | 导 | 昌 | 必 日 -r 可 -= 口 | 
eminated> Java Class File Disassembler [Program] C:\Program Fles (x86)\avaydk1.6.0_33\binVavap.EXE 


| 
Compiled from "HelloJni java™ | 
PN Gane com exomple hlioini Holoh edonde ancroid app Act el 


Signature: (Landroid/os/Bundle: 
public native java Jang. String stringFromJNIO:- 
Signature: QLjava/lang/String: 


3-6 控制 台 显示 javap 工具 的 输出 
原生 代码 不 易 产生 异常 ， 处 理 域 和 调用 Java 方法 可 能 导致 Java 异常 。 
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3.5 “异常 处 理 


异常 处 理 是 Java 程序 设计 语言 的 重要 功能 ，JNI 中 的 异常 行为 与 Java 中 的 有 所 不 同 ， 
在 Java 中 ， 当 抛 出 一 个 异常 时 ， 虚 拟 机 停止 执行 代码 块 并 进入 调用 栈 反 向 检查 能 处 理 特定 
类 型 异常 的 异常 处 理 程序 代码 块 ， 这 也 叫做 捕获 异常 。 虚 拟 机 清除 异常 并 将 控制 权 交 给 异 
常 处 理 程序 。 相 比 之 下 ，JNI 要 求 开发 人 员 在 异常 发 生 后 显 式 地 实现 异常 处 理 流 。 


3.5.1 捕获 异常 


JNIEnv 接口 提供 了 一 组 与 异常 相关 的 函数 集 ， 在 运行 过 程 中 可 以 使 用 Java 类 查看 这 
些 函 数 ， 以 程序 清单 3-31 为 例 。 


程序 清单 3-31 ” 抛 出 异常 的 Java 例子 


public class JavaClass { 


private void throwingMethod() throws NullPointerException { 
throw new NullPointerException("Null pointer"); 

} 

/*# 

* 访问 方法 (原生 方法 ) 。 

wd 

Private native void accessMethods(); 


} 


调用 throwingMethod 方法 时 ，accessMethods 原生 方法 需要 显 式 地 做 异常 处 理 。JNI 
提供 了 ExceptionOccurred 函数 查询 虚拟 机 中 是 否 有 挂 起 的 异常 。 在 使 用 完 之 后 ， 异 常 处 理 
程序 需要 用 ExceptionClear 函数 显 式 地 清除 异常 ， 如 程序 清单 3-32 所 示 。 


程序 清单 3-32 ”原生 代码 中 的 异常 处 理 


jthrowable ex; 

(*env) ->CallVoidMethod (env, instance, throwingMethodId); 
ex = (*env)->ExceptionOccurred (env); 

if (0 != ex) { 


(*env) ->ExceptionClear (env); 


/* Exception handler. */ 


} 
3.5.2” 抛 出 异常 
JNI 也 允许 原生 代码 抛 出 异常 。 因 为 异常 是 Java 类 ， 应 该 先 用 FindClass 函数 找到 异 
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常 类 ， 用 ThrowNew 函数 可 以 初始 化 且 抛 出 新 的 异常 ， 如 程序 清单 3-33 所 示 。. 


程序 清单 3-33 ”原生 代码 中 抛 出 异常 


jclass clazz; 


clazz = (*env)->FindClass (env, "java/lang/NullPointerException"); 
if (0 ! = clazz) { 
(*env) ->ThrowNew (env, clazz, "Exception message.")7 


} 

因为 原生 函数 的 代码 执行 不 受 虚拟 机 的 控制 ， 因 此 抛 出 异常 并 不 会 停止 原生 函数 的 执 
行 并 把 控制 权 转交 给 异常 处 理 程序 。 到 抛 出 异常 时 ， 原 生 函 数 应 该 释放 所 有 已 分 配 的 原生 
资源 ， 例 如 内 存 及 合适 的 返回 值 等 。 通 过 JNIEnv 接口 获得 的 引用 是 局 部 引用 且 一 旦 返回 
原生 函数 ， 它 们 自动 地 被 虚拟 机 释放 。 


3.6 局 部 和 全 局 引用 


引用 在 Java 程序 设计 中 扮演 非常 重要 的 角色 。 虚拟 机 通过 追踪 类 实例 的 引用 并 收回 不 
再 引用 的 垃圾 来 管理 类 实例 的 使 用 期 限 。 因 为 原生 代码 不 是 一 个 管理 环境 ， 因 此 JNI 提供 
了 一 组 函数 允许 原生 代码 显 式 地 管理 对 象 引用 及 使 用 期 间 原生 代码 。JNI 支持 三 种 引用 : 
局 部 引用 、 全 局 引用 和 弱 全 局 引用 。 下 面 将 详细 介绍 这 几 类 引用 。 


3.6.1 局 部 引用 


大 多 数 JNI 函数 返回 局 部 引用 。 局 部 引用 不 能 在 后 续 的 调用 中 被 缓存 及 重用 ， 主 要 因 
为 它们 的 使 用 期 限 仅 限于 原生 方法 ， 一 旦 原生 函数 返回 ， 局 部 引用 即 被 释放 。 例 如 : 
FindClass 函数 返回 一 个 局 部 引用 ， 当 原生 方法 返回 时 ， 它 被 自动 释放 ， 也 可 以 用 
DeleteLocalRef 函数 显 式 释 放 原 生 代 码 ， 如 程序 清单 3-34 所 示 。 


程序 清单 3-34 ”删除 一 个 局 部 引用 


jclass clazz; 
clazz = (*env)->FindClass(env, "java/lang/string"); 


ei ->DeleteLocalRef (env, clazz); 

根据 JNI 的 规范 , 虚拟 机 应 该 允许 原生 代码 创建 最 少 16 个 局 部 引用 。 在 单个 方法 调用 
时 进行 多 个 内 存 密 集 型 操作 的 最 佳 实践 是 删除 未 用 的 局 部 引用 。 如 果 不 可 能 ， 原 生 代码 可 
以 在 使 用 之 前 用 EnsureLocalCapacity 方法 请 求 更 多 的 局 部 引用 槽 。 
3.6.2 全 局 引用 


全 局 引用 在 原生 方法 的 后 续 调用 过 程 中 依然 有 效 ， 除 非 它 们 被 原生 代码 显 式 释放 。 
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1. 创建 全 局 引用 
可 以 用 NewGlobalRef 函数 将 局 部 引用 初始 化 为 全 局 引用 ， 如 程序 清单 3-35 所 示 。 


程序 清单 3-35 ”用 给 定 的 局 部 引用 创建 全 局 引用 


jclass localClazz; 
jclass globalClazz; 


localClazz = (*env)->FindClass(env, "java/lang/string"); 
globalClazz = (*env)->NewGlobalRef (env, localClazz); 


(*env) ->DeleteLocalRef (env, localClazz); 
2. 删除 全 局 引用 


当 原 生 代码 不 再 需要 一 个 全 局 引用 时 ， 可 以 随时 用 DeleteGlobalRef 函数 释放 它 ， 如 
程序 清单 3-36 所 示 。 


程序 清单 3-36 ”删除 一 个 全 局 引用 


(*env) ->DeleteGlobalRef (env, globalClazz); 


3.6.3” 弱 全 局 引用 
全 局 引用 的 另 一 种 类 型 是 弱 全 局 引用 。 与 全 局 引用 一 样 ， 弱 全 局 引用 在 原生 方法 的 后 
续 调 用 过 程 中 依然 有 效 。 与 全 局 引用 不 同 ， 弱 全 局 引用 并 不 阻止 潜在 的 对 象 被 垃圾 收回 。 
1. 创建 弱 全 局 引用 
可 以 用 NewWeakGlobalRef 函数 对 弱 全 局 引用 进行 初始 化 ， 如 程序 清单 3-37 所 示 。 
程序 清单 3-37 ”用 给 定 的 局 部 引用 创建 弱 全 局 引用 


jclass weakGlobalClazz; 
weakGlobalClazz = (*env)—->NewWeakGlobalRef (env, localClazz); 


2. 弱 全 局 引用 的 有 效 性 检验 


可 以 用 IsSameObject 函数 检验 一 个 弱 全 局 引用 是 否 仍 然 指向 活动 的 类 实例 , 如 程序 清 
单 3-38 所 示 . 


程序 清单 3-38 ”检验 弱 全 局 变量 是 否 仍然 有 效 


if (UNI_FRALSE == (*env)->IsSameObject (env, weakGlobalClazz, NULL)) { 
/* 对 象 仍然 处 于 活动 状态 且 可 以 使 用 */ 
} else { 


/* 对 象 被 垃圾 回收 器 收回 ， 不 能 使 用 */ 
} 
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3. 删除 弱 全 局 引用 
可 以 随时 用 DeleteWeakGlobalRef 函数 释放 弱 全 局 引用 ， 如 程序 清单 3-39 所 示 。 


程序 清单 3-39 ”删除 一 个 弱 全 局 引用 


(*env) ->DeleteWeakG1obalRef (env, weakGlobalClazz); 


全 局 引用 显 式 释放 前 一 直 有 效 ， 它 们 可 以 被 其 他 原生 函数 及 原生 线程 使 用 。 


3.7 线程 


作为 多 线程 环境 的 一 部 分 , 虚拟 机 支持 运行 的 原生 代码 。 在 开发 原生 构件 时 要 记 住 NI 

。 只 在 原生 方法 执行 期 间 及 正在 执行 原生 方法 的 线程 环境 下 局 部 引用 是 有 效 的 ， 局 
部 引用 不 能 在 多 线程 间 共 享 ， 只 有 全 局 引用 可 以 被 多 个 线程 共享 。 

e 被 传递 给 每 个 原生 方法 的 JNIEnv 接口 指针 在 与 方法 调用 相关 的 线程 中 也 是 有 效 
的 ， 它 不 能 被 其 他 线程 缓存 或 使 用 。 


3.7.1 同步 


同步 是 多 线程 程序 设计 最 重要 的 特征 。 与 Java 的 同步 类 似 ，JNI 的 监视 器 允许 原生 代 
码 利用 Java 对 象 同步 ， 虚 拟 机 保证 存 取 监 视 器 的 线程 能 够 安全 执行 ， 而 其 他 线程 等 待 监视 
器 对 象 变 成 可 用 状态 。Java 应 用 程序 中 的 同步 如 程序 清单 3-40 所 示 。 

程序 清单 3-40 ”Java 同步 代码 块 


synchronized(obj) { 
/* 同 步 线程 安全 代码 块 。 */ 
} 


在 原生 代码 中 , 相同 级 别 同步 可 以 用 JNI 的 监视 器 方法 实现 的 , 如 程序 清单 3-41 所 示 。 
程序 清单 3-41 Java 同步 代码 块 的 原生 等 价 


if (UNI_OK == (*env)->MonitorEnter(env, obj)) { 
/* 错误 处 理 */ 
} 


/* 同步 线程 安全 代码 块 。*/ 
if (JNI OK == (*env)->MonitorExit(env, obj)) { 


/* 错误 处 理 .*/ 
} 
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注意 
对 MonitorEnter 函数 的 调用 应 该 与 对 MonitorExit 的 调用 相 匹 配 ， 从 而 避免 代码 出 现 
死 锁 。 


3.7.2 原生 线程 


为 了 执行 特定 任务 ， 这 些 原生 构件 可 以 并 行使 用 原生 线程 。 因 为 虚拟 机 不 知道 原生 线 
程 ， 因 此 它们 不 能 与 Java 构件 直接 通信 。 为 了 与 应 用 的 依然 活跃 部 分 交互 ， 原 生 线 程 应 该 
先 附着 在 虚拟 机 上 。 

JNI 通过 JavaVM 接口 指针 提供 了 AttachCurrentThread 函数 以 便于 让 原生 代码 将 原生 
线程 附着 到 虚拟 机 上 ， 如 程序 清单 3-42 所 示 ，JavaVM 接口 指针 应 该 尽早 被 缓存 ， 否 则 的 
话 它 不 能 被 获取 。 


程序 清单 3-42 ”将 当前 线程 与 虚拟 机 附着 和 分 离 


JavaVM* cachedJvm; 
JNIEnv* env; 


/* 将 当前 线程 附着 到 虚拟 机 */ 
(*cachedJvm) ->AttachCurrentThread(cachedJvm, &env, NULL); 


/* 可 以 用 JNIEnv 接口 实现 线程 与 Java 应 用 程序 的 通信 */ 
/* 将 当前 线程 与 虚拟 机 分 离 */ 


(*cachedJvm) ->DetachCurrentThread (cachedJvm); 

对 AttachCurrentThread 函数 的 调用 允许 应 用 程序 获得 对 当前 线程 有 效 的 JNIEnv 接口 
指针 。 将 一 个 已 经 附着 的 原生 线程 再 次 附着 不 会 有 任何 副作用 。 当 原生 线程 完成 时 ， 可 以 
用 DetachCurrentThread 函数 将 原生 线程 与 虚拟 机 分 离 。 


3.8 小 结 


本 章 介绍 了 用 JNI 技术 实现 Java 应 用 程序 与 原生 代码 之 间 通 信 的 方法 ， 关 于 JNI 技术 
的 更 多 信息 和 可 用 的 JNI API 可 以 访问 http://docs.oracle.com/javase/1.5.0/docs/guide/ini/spec/ 
jniTOC.html 网 站 ， 在 Oracle 的 JNI 文档 找 查 到 。 

正如 你 已 经 看 到 的 , 对 JNI 所 作 的 任何 操作 需要 调用 2 一 3 个 函数 , 实现 大 量 的 原生 方 
法 并 让 他 们 与 Java 类 同步 很 容易 成 为 一 个 繁杂 的 任务 。 第 4 章 将 学 习 能 够 基于 已 经 存在 的 
代码 接口 自动 生成 INI 代码 的 开放 源 代码 的 解决 方案 。 
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使 用 SWIG 自动 生成 JNI 代码 


第 3 章 介绍 了 JNI 技 术 以 及 将 原生 代码 和 Java 应 用 程序 连接 的 方法 。 如 前 所 述 ， 实现 
JNI 封装 代码 和 处 理 数据 类 型 之 间 的 转换 是 烦琐 且 耗 时 的 开发 任务 。 本 章 将 介绍 简化 的 包 
装 器 和 接口 生成 器 (SWIG，Simplified Wrapper and Interface Generator)，SWIG 是 可 以 通过 
自动 生成 必要 的 JNI 封装 代码 来 简化 上 述 过 程 的 开发 工具 。 

SWIG 不 是 Android 或 Java 的 专用 工具 。 它 是 一 个 可 以 生成 许多 其 他 编程 语言 代码 
的 、 广 泛 使 用 的 工具 。 由 于 SWIG 十 分 庞大 ， 本 章 只 会 介绍 下 列 能 让 你 初步 了 解 SWIG 的 
主要 概念 和 APTI: 

。 为 原生 代码 定义 SWIG 接口 
基于 所 定义 的 接口 生成 INI 代码 
将 SWIG 集成 到 Android 构建 过 程 中 
包装 C/C++ 代码 
异常 处 理 
使 用 内 存 管理 
在 原生 代码 中 调用 Java 程序 
由 于 SWIG 简化 了 JNI 代码 的 开发 ， 在 以 后 几 章 中 会 经 常用 到 SWIG。 


4.1 什么 是 SWIG 


SWIG 是 一 个 编译 时 软件 开发 工具 ， 它 能 生成 将 用 C/C++ 编写 的 原生 模块 与 包括 Java 
在 内 的 其 他 编程 语言 进行 联接 的 必要 代码 。SWIG 不 仅 是 一 个 代码 生成 器 ， 还 是 一 个 接口 编 
译 器 。 它 不 定义 新 的 协议 ， 也 不 是 一 个 组 件 框架 或 者 一 个 特定 的 运行 时 库 。SWIG 把 接口 
文件 看 做 输入 ， 并 生成 必要 的 代码 在 Java 中 展示 接口 ， 从 而 让 Java 能 够 理解 原生 代码 中 
的 接口 定义 。SWIG 不 是 一 个 存根 生成 器 ， 它 产生 将 要 被 编译 和 运行 的 代码 。 
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SWIG 最 初 是 在 1995 年 用 于 科学 计算 的 应 用 而 开发 出 来 的 ,现在 它 已 经 发 展 成 在 GNU 
GPL 开源 许可 下 发 布 的 通用 工具 。 想 了 解 SWIG 的 更 多 相关 信息 ， 请 登录 www.swig.org。 


4.2 安装 


SWIG 可 应 用 于 包括 Windows、Mac OSX 和 Linux 在 内 的 大 多 数 操作 系统 平台 。 本 书 
撰写 时 ,SWIG 的 最 新 版 本 是 2.0.7， 其 代码 在 其 官方 网 站 www.swig.org 上 以 源 代码 包 的 形 
式 提供 。 除了 Windows 二 进 制 文件 以 外 ,其 他 操作 系统 上 的 SWIG 二 进 制 文件 都 通过 特定 
操作 系统 库 提 供 。 本 节 将 详细 介绍 几 个 主要 操作 系统 中 SWIG 二 进 制 文件 的 下 载 方式 和 安 
装 指令 。 


4.2.1 Windows 平台 上 SWIG 的 安装 


Windows 平台 上 SWIG 二 进 制 文件 通过 www.swig.org/download.html 网 站 的 SWIG 下 
载 页 面 下载 。 如 图 4-1 所 示 ， 单 击 链接 下 载 SWIG 安装 包 。 


€E Download SWIG - Windows Internet Explorer 


GO m/min 5 B+ x| 局 ES | | 


Sy16 Home 。 Development Maing Lists Bugs and Patches 
loforaation 
Whatis SWIG? 
The Latest Release 


The latest release is swig-2.0.7. View the release notes. 


Wagon wer it omni CEErinnin 207 aideapbalecaabie 


Many Unix.-like operating systems also include packages of SWIG (e.g. Debian GNU/Linux, 
FreeBSD, Cygwin). Consuk your package management application to see if your operating system 
does. 


图 4-1 Windows 下 SWIG 下 载 链接 


SWIG 安装 包 是 一 个 ZIP 格式 的 文件 ，Windows 操作 系统 支持 ZIP 格式 的 文件 。 下 载 
完成 后 ， 右 击 ZIP 文件 ， 并 在 上 下 文 菜单 中 选择 Extract All 打开 Extract Compressed Folder 
向 导 对 话 框 。 单 击 Browse 按钮 , 选择 SWIG 文件 的 目标 目录 。 第 1 章 已 经 讲 过 ，C:android 
目录 是 用 于 保存 开发 工具 的 根 目 录 ， 因 此 将 C:\android 选 作 目标 目录 。 因 为 ZIP 文件 中 已 
经 包含 一 个 名 字 为 swigwin-2.0.7 的 子 目 录 ， 其 中 包含 Android 的 SWIG 文件 ， 因 此 不 需要 
建立 专用 的 空白 目标 目录 。 单 击 Extract 按钮 开始 安装 。 

和 已 经 安装 的 其 他 开发 工具 类 似 ， 为 了 方便 访问 SWIG， 应 该 将 其 安装 目录 添加 到 系 
统 的 可 执行 文件 搜索 路 径 中 。 从 System Properties 中 打开 Environment Variables 对 话 框 , 单 
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击 New 按钮 .如 图 4-2 所 示 , 在 New System Variable 对 话 框 中 ,将 变量 名 设置 为 SWIG_HOME， 
变量 值 设置 为 SWIG 的 安装 目录 ， 如 C:\android\swigwin-2.0.7。 


New User Variable Ix| 


图 4-2 新 建 SWIG_HOME 环境 变量 


在 系统 变量 列表 中 双击 PATH 变量 ， 在 变量 值 后 添加 :%SWIG_HOME%， 如 图 4-3 


Edit System Variable [x| 
Variable name: Path 
Variable value: ANDROID_NDK_HOME %; %SWIG_HOME% | 
Ce lee | 


4-3 向 系统 PATH 变量 中 追加 SWIG 二 进 制 文件 路 径 


如 果 安 装 成 功 ， 你 将 看 到 SWIG 版 本 号 ， 如 图 4-4 所 示 。 


:NUsersvoncinaryswig -version 

WIG Version 2.8.7 

mpiled with i586-mingw32nsvc-g+* [i586-pc-mingv32msvc] 
nfigured options: +*pere 


lease see http://wwu.swig.org for reporting bugs and further infornation 


:\sers\oncinar> 


图 4-4 验证 SWIG 安装 效果 
4.2.2 在 MacOS X 下 安装 


SWIG 网 站 上 没有 提供 Mac OS X 平台 安装 包 ， 用 Homebrew 包 管 理 器 下 载 并 安装 
SWIG。 为 了 使 用 Homebrew， 需 要 将 其 装 在 主机 上 。Homebrew 是 一 个 基于 控制 台 的 安装 
应 用 程序 ， 从 Homebrew 安装 页 面 上 复制 安装 指令 ， 如 图 4-5 所 示 。 
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Cle J ert]® ps/ oneb.com/ me/homebrew wt/instaliarior] [= 


SignupandPricing Explore GitHub Features Blog Signin 


加 may homebrew GWateh sn) 了 Fork < 43 


Code Network Pul Requests 278 lssues 478 Wd Graphs 


Home Pages 。 Wi History GitAccess 


Installation Poge Heom 


Paste this at a shell prompt: 


Tusr/bin/ruby -e "Ss(/usr/bin/curl -45SL https://raw-github.com/axcl/hosebrew/master/Library/Contributions/install_hosebrew.rb)” 


Read the script first t you lke. 


The script installs Homebrew to /usr/local so that you don' need sudo when you brew install .Itis a careful script it can be run even i 
you have stufl installed to /usr/local already. It telis you exactly whati will do betore It does It to0. And you have to confirm everything ft wil 
do before it starts. 


4-5 Homebrew 安装 命令 


打开 一 个 终端 窗口 ， 在 命令 提示 符 下 粘贴 安装 命令 ， 如 图 4-6 所 示 ， 然 后 按 回 车 键 开 
始 安装 。 该 命令 首先 下 载 Homebrew 安装 脚本 ， 然 后 用 Ruby 执行 该 脚本 ， 按 照 屏 幕 上 的 
指令 完成 安装 过 程 。 


$ /usr/bin/ruby ~e “${/usr/bin/curl -fsSL https://raw.github, com/mxcl/homebrew/ 国 
master/Library/Contributions/install_homebrew. rb)" 

==> This script will install: 

/usr/\ocal/bin/brev 

Jusr/local/Library/Fornula/... 

/Jusr/local/Librory/Homebrew/... 


press enter to continue 

==> /usr/bin/sudo /bin/mkdir /usr/Local 

mm /usr/bin/sudo /bin/chmod gerwx /usr/\ocal 

==> /usr/bin/sudo /usr/bin/chgrp adnin /usr/\ocal 

“> Downloading and Installing Homebrew... 

==> Installation successful! 

You should run “brew doctor' sbefores you install anything. 
| type: brew help . 
$ 


4-6 ”从 命令 行 安装 Homebrew 


安装 完 Homebrew 就 可 以 安装 SWIG 了 。 打 开 终 端 窗口 ， 在 命令 提示 符 下 执行 brew 
install swig， 如 图 4-7 所 示 。Homebrew 将 下 载 SWIG 的 源 代码 及 其 扩展 工具 ,然后 自动 编 
译 并 安装 SWIG。 

为 了 验证 安装 是 否 成 功 ， 打 开 一 个 新 的 终端 窗口 ， 在 命令 行 方式 下 执行 swig -version。 
如 果 安 装 成 功 ， 会 看 到 SWIG 版 本 号 ， 如 图 4-8 所 示 。 
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$ brev install swig 

==> Installing swig dependency: pcre 

==> Downloading ftp://ftp.csx.cam.nc.uk/pub/software/progranning/pcre/pere 
dd dtd id dd ddd bid dd bid dd dd ddd itd dd bid 


==> ./configure --prefix=/usr/tocat/CetLar/pcre/8.31 ~—-enable-utf8 ~—enable-uni 
“=> nake test 
==> nake install 
/usr/\local/Cellar/pcre/B.31: 138 files, 3.24, built in 54 seconds 
mm> Installing swig 
Downloading http://downloads.sourceforge.net/project/swiqg/swig/swig-2 
/configure —-prefix=/usr/local/Cellar/swig/2 
nake 
=> nake install 
Et 598 files, 6.24, built in 66 seconds 
$ 


图 4-7 使 用 Homebrew 安装 SWIG 


$ swig -version 

SWIG Version 2.8.7 

Compiled with /usr/bin/9++-4.2 [i386-appLe-darwin19， 
Configured options: +pcre 


si See http://www. swig.org for reporting bugs and further infornation 
$ 


图 4-8 验证 SWIG 是 否 安装 成 功 
4.2.3 在 Ubuntu Linux 下 安装 


SWIG 网 站 没 提 供 Linux 平台 的 安装 包 ，Ubuntu Linux 软件 资源 库 包 含 最 新 版 本 的 
SWIG, 可 以 用 系统 包 管理 器 安装 SWIG。 再 打开 一 个 终端 窗口 ,在 命令 提示 符 下 执行 sudo 
apt-get install swig， 如 图 4-9 所 示 。 系 统 包 管 理 器 将 自动 下 载 并 安装 SWIG 及 其 扩展 工具 。 


5 sudo apt-get install swig 


IReading state information..,. Done 
The following extra packages will be installed: 

swig2.0 
Suggested packages: 

Swtg-doc swig-examples swig2.0-examples swtg2.6-doc 
The following NEW packages will be installed: 

swig swig2.0 
je upgraded, 2 newly installed, 6 to renove and 9 not upgraded. 
Need to get 9 B/1,126 kB of archives. 
After thts operation, 4,370 kB of additional disk space will be used. 
Do you want to conttnue [Y/n]? Y 
Selecting previously unselected package swig2.0. 
(Readtng database ... 166649 files and dtrectortes currently installed.) 
lunpacking swig2.9 (from .../swig2.0 2.6.4+*really2.90.4-4ubuntu2 i386.deb) ... 
Selecting previously unselected package swig. 
lunpacking swtg (from .../swlg_2.9.4+really2.6. 
Processing triggers for nan-db ... 
Setttng up swtg2.6 (2.0.4+really2.0.4-4ubuntu2) ... 
洁 议和 up swig (2.0.4+really2.6.4-4ubuntu2) ... 


4 


4-9 在 命令 行 方式 下 安装 SWIG 


4ubuntu2_t386.deb) ... 
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为 了 验证 安装 是 否 成 功 ， 打 开 一 个 新 的 终端 窗口 ， 在 命令 行 行 方 式 下 执行 swig -Version。 
如 果 安 装 成 功 ， 你 将 看 到 SWIG 版 本 号 ， 如 图 4-10 所 示 。 


5 swig -version 
SWIG Verston 2.6.4 
Conpiled with g++ [i686-pe-linux-gnu] 


configured options: +pcre 


pe see http://www.swig.org for reporttng bugs and further tnfornatton 
$ 


图 4-10 验证 SWIG 是 否 安装 成 功 


4.3 ”通过 示例 程序 试用 SWIG 


在 深入 学 习 SWIG 之 前 ， 通 过 一 个 示例 程序 我 们 可 以 更 好 地 理解 SWIG 的 工作 方法 。 
Android 平台 是 建立 在 Linux 操作 系统 之 上 的 多 用 户 平台 , 它 在 虚拟 机 沙 箱 上 运行 应 用 程序 
并 把 它们 看 成 系统 上 的 不 同 用 户 以 保证 平台 安全 。 在 Linux 系统 中 ， 给 每 个 用 户 分 配 一 个 
用 户 ID， 可 以 用 POSIX OS API 的 getuid 函数 查询 这 个 用 户 ID 。 作 为 一 个 平台 独立 的 编 
程 语言 ，Java 不 提供 对 这 些 函 数 的 访问 。 作 为 该 示例 应 用 程序 的 一 部 分 ， 我 们 要 做 以 下 几 
件 事 : 


写 一 个 SWIG 接口 文件 以 展示 getuid 函数 
将 SWIG 集成 到 Android 构建 过 程 中 
将 SWIG 生成 的 源 文件 加 入 Android.mk 构建 文件 中 
用 SWIG 生成 的 代理 类 查询 getuid 
在 屏幕 上 显示 结果 
你 将 用 hello-jni 这 个 示例 项 目 进行 测试 。 打 开 Eclipse IDE， 进 入 hello-ini 项 目 。 如 前 
所 述 ， 在 接口 文件 上 操作 SWIG。 


4.3.1 接口 文件 


SWIG 接口 文件 包含 函数 原型 .类 和 变量 声明 , 它 的 语法 和 普通 的 C /C++ 头 文件 一 样 。 
除了 C/C++ 关键 字 和 预 处 理 器 指令 ， 接 口 文件 还 包含 SWIG 特有 的 预 处 理 器 指令 ， 该 指 
令 可 用 于 优化 生成 封装 代码 。 

为 了 展示 getuid， 需 要 定义 一 个 接口 文件 。 在 Project Explorer 视图 中 ， 右 击 hello-jni 
项 目下 的 jni 目录 ， 选 择 New | File 打开 New File 对 话 框 。 如 图 4-11 所 示 ， 将 文件 名 设置 
为 Unix.i， 然 后 单 击 Finish 按钮 。 
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3 New File 


图 4-11 创建 Unix.i 的 SWIG 接口 文件 
在 Editor 视图 中 填 入 Unix.i 内 容 ， 如 程序 清单 4-1 所 示 。 


程序 清单 4-1 Unix.i 接口 文件 内 容 
/* 模块 名 是 Unix. */ 


%module Unix 


%{ 

/* 包含 POSIX 操作 系统 API. */ 
#include < unistd.h> 

%} 


/* 告诉 SWIG uid t. */ 
typedef unsigned int uid t; 


/* 让 SWIG 包装 getuid 函数 . */ 
extern uid t getuid(void); 


在 进行 下 一 步 操作 之 前 (调用 SWIG)， 简 单 介绍 一 下 接口 文件 。 

1. 注释 

Unix 接口 文件 的 注释 行 与 C 的 注释 行 风格 相同 , 以 开头 , 以 */ 结 尾 , 如 程序 清单 4-12 
所 示 。 与 编译 器 一 样 ，SWIG 也 不 处 理 注释 行 ， 它 们 只 是 为 开发 人 员 提 供 对 接口 文件 的 注 
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释 说 明 。 


程序 清单 4-2 ”Unix.i 用 注释 开头 
/+ 模块 名 是 Unix. */ 


2. 模块 名 


每 次 调用 SWIG 都 需要 指定 一 个 模块 名 , 模块 名 用 于 给 生成 的 封装 文件 命名 ,用 SWIG 
特定 的 预 处 理 指令 %module 指定 模块 名 , 该 指令 放 在 每 个 接口 文件 的 开头 。 遵循 这 个 规则 ， 
Unix.i 接口 文件 也 由 模块 名 定义 语句 开头 ， 比 如 将 模块 名 定义 为 Unix， 如 程序 清单 4-3 
所 示 。 

程序 清单 4-3 ”定义 Unix.i 的 模块 名 


%module Unix 
3. 用 户 定义 的 代码 


SWIG 只 在 生成 封装 代码 时 使 用 接口 文件 ， 文 件 内 容 也 一 样 ， 因 此 要 把 用 户 自 定义 的 
代码 包含 在 生成 的 文件 中 ， 比 如 编译 生成 的 代码 所 需要 的 头 文件 等 。 当 SWIG 生成 封装 代 
码 时 ， 代 码 被 分 为 五 个 部 分 ，SWIG 提供 预 处 理 指令 让 开发 人 员 指 定 代 码 片 段 哪 个 部 分 ， 
SWIG 的 预 处 理 指令 语法 如 程序 清单 4-4 所 示 。 


程序 清单 4-4 ”SWIG 插入 预 处 理 指令 的 语法 


多 < section > %{ 
这 个 代码 块 将 按照 section 的 指定 包含 在 生成 代码 的 相应 部 分 


%} 


< section > 部 分 内 容 可 以 如 下 : 

e begin: 将 代码 块 放 在 生成 的 封装 文件 的 开头 位 置 ， 主 要 用 于 定义 文件 后 面部 分 使 
用 的 预 处 理 器 宏 。 

。 runtime: 将 代码 块 放 在 SWIG 的 内 部 类 型 检查 及 其 他 支持 函数 之 后 。 

。 header: 将 代码 块 放 在 header 部 分 ， 这 部 分 在 头 文件 和 其 他 帮助 函数 之 后 ， 这 是 
生成 的 文件 中 插入 代码 的 默认 位 置 ， 可 以 缩写 为 %{ .. . %}。 

e wrapper: 将 代码 块 放 在 生成 的 封装 函数 之 后 。 

。 init: 将 代码 块 放 入 装 入 时 初始 化 模块 的 函数 中 。 

如 程序 清单 4-5 所 示 ，Unix.i 接口 文件 用 插入 头 预 处 理 指令 的 简短 形式 在 生成 的 封装 

代码 插入 一 个 头 文件 。 
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程序 清单 4-5 ”Unix.i 将 一 个 头 文件 插入 到 生成 的 封装 代码 
%{ 
/+ 包含 POSIX 操作 系统 API. */ 


#include < unistd.h> 
务 } 


4. 类 型 定义 

SWIG 能 理解 C/C++ 的 所 有 数据 类 型 ， 但 是 把 其 他 的 东西 都 看 成 对 象 并 把 它们 封装 成 
指针 。 从 getuid 函数 的 声明 可 以 看 出 该 函数 的 返回 值 类 型 为 uid_t， 它 并 不 是 一 个 标准 的 
C/C++ 的 数据 类 型 。 因 此 ，SWIG 把 它 看 做 一 个 对 象 并 把 它 封装 为 一 个 指针 。 由 于 vid t 仅 
仅 是 一 个 简单 的 基于 无 符号 整 型 的 类 型 名 而 不 是 一 个 对 象 ， 因 此 将 它 看 做 对 象 不 合适 。 如 
程序 清单 4-6 所 示 ，Unix.i 接口 文件 用 一 个 类 型 定义 让 SWIG 知道 getuid 函数 的 实际 返回 
值 类 型 。 

程序 清单 4-6 id_t 的 类 型 定义 


/* 告诉 SWIG uid t. */ 
typedef unsigned int uid t; 


5. 函数 原型 
Unix.i 接口 文件 以 getuid 函数 的 函数 原型 结尾 ， 如 程序 清单 4-7 所 示 。 


程序 清单 4-7 ”getuid 函数 原型 
/* 请 求 SWIG 封装 getuid 函数 */ 


extern uid t getuid(void) 
这 里 简单 解释 了 SWIG 如 何 获取 生成 封装 代码 的 指令 ， 从 而 在 Java 中 展示 原生 函数 。 
4.3.2 在 命令 行 方式 下 调用 SWIG 


既然 接口 准备 好 了 ， 可 以 调用 SWIG 以 生成 必要 封装 代码 ， 进 而 在 Java 中 展示 getuid 
函数 。SWIG 将 生成 两 组 文件 : 一 是 封装 C/C++ 代码 以 展示 原生 函数 ， 二 是 提供 访问 被 展 
示 函 数 的 代理 类 。 


1. 代理 类 的 Java 包 


应 该 在 调用 SWIG 之 前 创建 Java 包 目 录 。 在 Project Explorer 中 右 击 src 目录 ， 选 择 


New | Package 打开 New Java Package 对 话 框 ,如 图 4-12 所 示 , 设置 包 名 为 com.apress.swig， 
并 单 击 Finish 按钮 。 
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名 New Java Package 画 回 回 


Java Package 
Groate a now Java package. | 


Creates folders coresponding to packages. 
Name: [com apress swig 


口 Greate package info java 


@ 


图 4-12 SWIG 文件 的 Java 包 


2. 调用 SWIG 


现在 可 以 调用 SWIG 了 。 打 开 一 个 终端 窗口 或 一 个 命令 提示 符 ， 进 入 hello-jni 项 目的 
导入 目录 ， 例 如 Ci\android\workspace\com.example.hellojni.HelloJni。 如 图 4-13 所 示 ， 在 命 
令 行 方式 下 执行 swig -java -package com.apress.swig -outdir src/com/apress/swig jni/Unix.i 
命令 。 


C:\windows\system32\cmd exe 


:android yorkspace\con. exanple helloini:HellodniYsvig -java -package com. aprest 


-swig ~outdir src/con/apress/swig jni/W 
:\android\workspace\con.exanple .hellojni.HelloJni>, 


图 4-13 在 命令 行 方式 下 调用 SWIG 


SWIG 解析 Unix.i 接口 文件 并 且 在 jni 目录 下 生成 C/C++ 封装 代码 Unix_wrap.c， 同 
时 在 com.apress.swig 包 中 生成 Java 代理 类 UnixJNLjava 和 Unix.java。 在 开始 深入 研究 这 
些 文件 之 前 ， 先 简化 一 下 这 个 过 程 。SWIG 可 以 被 集成 到 Android 构建 过 程 中 ， 而 不 需要 
在 命令 行 方式 下 手动 执行 。 


4.3.3 将 SWIG 集成 到 Android 构建 过 程 中 


1. SWIG 的 Android 构建 系统 


打开 Project Explorer， 右 击 jni 目录 ， 并 在 菜单 中 选择 New | File。 打 开 New File 对 话 
框 ， 创 建 一 个 名 为 my-swig-generate.mk 的 文件 ， 该 Makefile 片段 的 内 容 如 程序 清单 4-8 
所 示 。 


程序 清单 4-8 ”my-swig-generate.mk 文件 的 内 容 


# 
# Android 构建 系统 的 SWIG 扩 展 . 
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非 
# @author Onur Cinar 
提 


# 检查 变量 MY_SWIG_PRACKRGE 是 否 已 经 定义 
ifndef MY SWIG PACKAGE 

$ (error MY SWIG PACKAGE is not defined.) 
endif 


# 用 和 斜 线 替换 Java 目录 中 的 圆 点 
MY_ SWIG OUTDIR:= $(NDK_PROJECT PRTH) /src/S (subst .,/,$ (MY SWIG PACKAGE)) 
# SWIG 的 默认 类 型 是 C 
ifndef MY SWIG TYPE 
MY SWIG TYPE := c 
endif 


# 设 置 SWIG 的 模式 
ifeq ($(MY SWIG TYPE),cxx) 
MY_SWIG MODE := 一 c++ 
else 
MY_SWIG MODE := 
endif 


# 追加 SWIG 封装 源 文件 
LOCAL SRC FILES+= $ (foreach MY SWIG INTERFACE,\ 
$ (MY_SWIG_INTERFACES),\ 
$ (basename $ (MY _ SWIG INTERFACE)) wrap.$ (MY_ SWIG TYPE)) 


# 添加 . cxx 作为 C++ 扩展 名 
LOCAL CPP EXTENSION+ = .cxx 


# 生成 SWIG 封闭 代码 (indention should be tabs for this block) 
% Wrap.$ (MY SWIG TYPE) : %.i 

$(call host-mkdir,$ (MY_SWIG OUTDIR)) 

swig -java \ 

$ (MY_SWIG MODE) \ 

-package $ (MY _SWIG PACKAGE) \ 

-outdir $(MY_SWIG OUTDIR) \ 

$< 


2. 将 SWIG 集成 到 Android.mk 


为 了 使 用 这 个 构建 系统 片段 , 需要 修改 现 有 的 Android.mk 文件 。 为 了 运行 该 构建 系统 
片段 ， 需 要 在 Android.mk 文件 中 定义 三 个 新 变量 : 
e MY_SWIG_PACKAGE: 定 义 SWIG 生成 代理 类 的 Java 包 ,本 例 中 为 com.apress.swig 
package。 
e MY_SWIG_INTERFACES: 应 该 处 理 的 SWIG 接口 文件 列表 , 本 例 中 为 Unix.i file。 
e MY _SWIG MODE: SWIG 生成 封装 程序 的 指令 代码 类 型 ， 为 C 或 CH+， 本 例 中 
为 C 代码 。 
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打开 Project Explorer， 展 开 根 目录 下 的 jni 目录 ， 在 编辑 器 视图 下 打开 Android.mk。 
现在 开始 定义 该 项 目的 新 变量 , Android.mk 文件 增加 的 内 容 如 程序 清单 4-9 粗 体 部 分 所 示 。 


程序 清单 4-9 在 Android.mk file 中 定义 SWIG 变量 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := hello-jni 
LOCAL SRC FILES := hello-jni.c 


MY SWIG PACKAGE := com.apress.swig 
MY _ SWIG INTERFACES := Unix.i 
MY_SWIG TYPE := c 


include $ (LOCAL PATH)/my-swig-generate.mk 


include $ (BUILD SHARED LIBRARY) 


定义 了 这 些 新 变量 之 后 , Android.mk 文件 就 包含 了 本 节 前 面 定义 的 my-swig-generate.mk 
构建 系统 片段 。 构 建 系统 片段 首先 创建 Java 包 目 录 ， 然 后 根据 这 些 变量 设置 适当 参数 来 调 
用 SWIG。 由 于 SWIG 生成 的 封装 代码 也 应 该 编译 到 共享 库 里 ， 因 此 上 述 操作 应 该 在 建立 
共享 库 之 前 完成 。 构 建 系 统 片段 自动 地 将 生成 的 封装 文件 追加 到 LOCAL _SRC _FILES 变 
量 中 。 

如 图 4-14 所 示 ， 在 主 菜单 选择 Project | Build All 来 重新 构建 当前 项 目 ，Android NDK 
构建 日 志 表 明 Unix_wrapper.c 封装 代码 将 被 编译 到 共享 库 中 。 


(Problems Tasks Console 13 (DProperties WD LogCat 4 了 人 1 图 久久 BR 三 昌 vr3"= 0 | 
CDT Build Console [com.example.hellojni HelloJnil 


99:13:52 ****” Incremental Build of configuration Default for project com.example.hellojni.HelloJni "ww a 
sh “C:\\android\\android-ndk-r8\\ndk-build” all 


Gdbserver : [arm-linux-androideabi-4.4.3] libs/armeabi/gdbserver 
Gdbsetup : libs/armeabi/gdb.setup 
Cygwin : Generating dependency file converter script 


Compile thumb : hello-jni <= hello-jni.c 


Enpile thumb : hello-jni <= Unix_wrap.c 
SharedLibrary * iibheilo-jni.so 


Install : libhello-jni.so => libs/armeabi/libhello-jni.so 


09:13:57 Build Finished (took 4s.539ms) ~ 


图 4-14 构建 日 志 表明 封装 代码 已 被 编译 


4.3.4 更 新 Activity 
现在 通过 Unix 代理 Java 类 准确 地 展示 了 getuid 函数 。 为 了 校 验 该 函数 ， 可 以 修改 


92 


第 4 章 使 用 SWIG 自动 生成 JNI 代码 


HelloJni activity， 在 显示 器 上 显示 返回 值 。 打 开 Project Explorer， 展 开 src 目录， 然后 展开 
com.example.hellojni Java 包 ， 在 文本 编辑 器 中 打开 HelloJni， 按 照 程序 清单 4-10 所 示 修 改 
onCreate 方法 体 。 


程序 清单 4-10 ”从 Unix 代理 类 中 调用 getuid 函数 


override 


public void onCreate (Bundle savedInstanceState) 
{ 


super.onCreate (SavedInstanceState)7 


TextView tv = new TextView (this); 


tv.setText ("UID: " + Unix.getuid()); 
setContentView (tv); 
} 


4.3.5 执行 应 用 程序 


现在 应 用 程序 准备 就 绪 ， 在 主 菜单 上 选择 Run | Run 打开 图 4-15 所 示 的 应 用 程序 ， 
activity 将 调用 getuid 函数 ， 而 且 结果 将 显示 在 屏幕 上 。 


ID: 10040 


4-15 ”activity 显示 用 户 ID 


从 示例 程序 中 可 以 看 到 ，SWIG 能 够 自动 生成 向 Java 展示 原生 函数 所 有 必要 的 JNI 和 
Java 代码 。 


4.3.6 ”剖析 生成 的 代码 


为 了 能 够 在 Java 中 访问 原生 函数 ，SWIG 生成 了 两 个 Java 类 和 一 个 C/C++ 封 装 代码 ; 
e Unix_wrap.c: 包含 用 于 处 理 类 型 映射 以 及 将 选中 的 原生 函数 展示 给 Java 的 JNI 封 
装 函 数 ， 生 成 的 封装 函数 如 程序 清单 4-11 所 示 。 


程序 清单 4-11 生成 的 封装 getuid 函数 


SWIGEXPORT jlong JNICALL Java_com_apress_swig_UnixJNI_getuid(UNIEnV *jenv, 
jclass jcls) 
{ 


jlong jresult = 0， 
uid t result; 


93 


94 


Android C++ 高 级 编程 一 一 使 用 NDK 


(void)jenv; 


(void)jcls; 
result = (uid t)getuid(); 
jresult = (jlong)result; 


return jresult; 


} 


e UnixJNIjava: 包含 封装 程序 展示 的 所 有 函数 的 Java 原生 函数 声明 的 中 介 JNI 类 ， 
根据 Android.mk 文件 的 指定 ， 它 被 构建 在 com.apress.swig Java 包 中 ， 生 成 的 中 介 
JNI 类 如 程序 清单 4-12 所 示 。 


程序 清单 4-12 构建 JNI 中 间 类 


package com.apress.swig; 


public class UnixJNI { 
public final static native long getuid(); 


} 


e Unix.java: 含有 所 有 方法 以 及 全 局 变量 值 获取 和 设置 的 模块 类 ， 它 将 方法 调用 封 
装 在 中 间 JNI 类 中 以 实现 静态 类 型 检查 。 在 介绍 SWIG 处 理 对 象 的 方法 时 将 会 再 
次 讨论 这 个 问题 。 它 也 被 构建 在 com.apress.swig Java 包 中 ， 生 成 的 模块 类 如 程序 
清单 4-13 所 示 。 


程序 清单 4-13 ”生成 的 模块 类 


package com.apress.swig; 


public class Unix { 
public static long getuid() { 
return UnixJNI.getuid(); 
. 
} 


4.4 封装 C 语言 代码 


在 前 面 的 示例 中 ,已 经 学 过 怎样 通过 SWIG 展示 函数 。 本 节 将 学 习 如 何 用 SWIG 封装 
其 他 组 件 。 需 要 注意 的 是 接口 文件 中 定义 的 组 件 只 是 SWIG 用 来 在 Java 中 展示 的 ; 除非 在 
插入 的 预 处 理 程序 声明 中 做 了 声明 ， 和 否则 它们 不 会 包含 在 生成 的 文件 中 。SWIG 假定 所 有 
被 展示 的 组 件 都 在 代码 中 的 某 处 定义 过 。 如果 这 个 组 件 没有 被 定义 , 在 编译 时 构建 会 失败 。 


4.4.1 全 局 变量 


尽管 没有 像 Java 那样 的 全 局 变量 , SWIG 也 支持 全 局 变量 .SWIG 在 模块 类 里 生成 getter 
和 setter 方法 来 提供 对 原生 全 局 变量 的 访问 。 为 了 向 Java 展示 全 局 变量 ， 直 接 将 其 添加 到 
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如 程序 清单 4-14 所 示 的 接口 文件 中 。 


程序 清单 4-14 ”展示 Counter 全 局 变量 的 接口 文件 


Smodule Unix 


/* 全 局 变量 counter. */ 


extern int counter; 


处 理 接 口 文 件 时 ，SWIG 将 生成 相应 的 getter 和 setter 方法 ， 以 便于 在 Java 应 用 程序 
中 访问 全 局 变量 ， 如 程序 清单 4-15 所 示 。 


程序 清单 4-15 ”计数 器 全 局 变量 的 Getter and Setter 方法 
package com.apres.swig; 


public class Unix { 


public static void setCounter (int value) { 
UnixJNI.counter set (value); 


} 


public static int getCounter() { 
return UnixJNI.counter get(); 
} 
} 
除了 变量 ，SWIG 也 提供 对 运行 时 其 值 不 能 改变 的 常量 的 支持 。 
4.4.2 常量 


在 接口 文件 中 ， 常 量 可 以 用 #define 或 %constant 预 处 理 指 令 定 义 ， 如 程序 清单 4-16 


程序 清单 4-16 ”定义 两 个 常量 的 接口 文件 


%module Unix 


/* 用 define 指令 定义 的 常量 .*/ 
#define MAX WIDTH 640 

/* 用 %constant 指令 定义 的 常量 */ 
Sconstant int MAX HEIGHT = 320; 


SWIG 生成 一 个 名 为 <Module>Constant 的 Java 接口 ， 在 那个 接口 中 常量 被 展示 为 静态 
final 变量 ， 如 程序 清单 4-17 所 示 。 


程序 清单 4-17 展示 两 个 常量 的 UnixConstants 接口 


package com.apress.swig; 
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public interface UnixConstants { 
public final static int MAX WIDTH = UnixJNI.MAX WIDTH get(); 
public final static int MAX HEIGHT = UnixJNI.MAX HEIGHT get(); 
} 


默认 情况 下 ，SWIG 生成 运行 库 常量 。 通 过 运行 库 在 原生 代码 中 调用 JNI 函数 完成 党 
量 初 始 化 。 可 以 在 接口 文件 中 使 用 %javaconst 预 处 理 指令 修改 常量 值 ， 如 程序 清单 4-18 
所 示 。 

程序 清单 4-18 为 MAX_WIDTH 生成 编译 时 常数 的 指令 

%module Unix 

/* 用 定义 指令 定义 常量 ，*/ 

Sjavaconst (1); 

#define MAX WIDTH 640 


/* 用 %constant 指令 定义 常量 */ 

Sjavaconst (0); 

%constant int MAX HEIGHT = 320; 

这 个 预 处 理 指令 告诉 SWIG 生成 一 个 编译 时 常量 MAX_WIDTH 和 运行 库 常量 MAX_ 
HEIGHT。 现 在 Java 的 常量 接口 如 程序 清单 4-19 所 示 。 


程序 清单 4-19 ”展示 编译 时 常量 的 UnixConstants 接口 


package com.apress.swig; 


public interface UnixConstants { 

public final static int MAX WIDTH = 640; 

public final static int MAX HEIGHT = UnixJNI.MAX HEIGHT get(); 
} 


特定 情况 下 ， 程 序 开发 人 员 希 望 限制 对 一 个 变量 的 写 操作 ， 并 将 它 展 示 为 Java 只 读 。 
4.4.3 ”只 读 变 量 
SWIG 提供 %immutable 预 处 理 指令 来 标记 一 个 只 读 变 量 ， 如 程序 清单 4-20 所 示 。 


程序 清单 4-20 ”在 接口 文件 中 启用 和 禁用 只 读 模式 


%module Unix 


/* 启用 只 读 模式 */ 


Simmutable; 


/* 只 读 变量 . */ 


extern int readonly; 
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/* 禁用 只 读 模式 */ 
Smutable; 


/* 读 - 写 变量 */ 


extern int readWrite; 
不 会 为 为 只 读 变量 生成 setter 方法 ， 如 程序 清单 4-21 所 示 。 
程序 清单 4-21 ”不 会 为 只 读 变量 生成 setter 方法 


package com.apress.swig; 


public class Unix implements UnixConstants { 


public static int getReadonly() { 
return UnixJNI.readonly get(); 
} 


public static void setReadWrite (int value) { 
UnixJNI.readWrite set (value); 


} 


public static int getReadWrite() { 
return UnixyJNI.readWrite get(); 
} 
} 


除了 常量 和 只 读 变量 ， 应 用 程序 中 经 常 使 用 枚 举 ， 枚 举 是 一 组 命名 的 常量 值 集 。 
4.4.4 枚 举 


SWIG 可 以 处 理 命名 枚 举 和 匿名 枚 举 。 根 据 开发 人 员 的 不 同 选择 或 者 不 同 的 目标 Java 
版 本 ， 可 以 通过 四 种 不 同 的 方法 生成 枚 举 。 

1. 匿名 

匿名 枚 举 可 以 在 接口 文件 中 声明 ， 如 程序 清单 4-22 所 示 。 

程序 清单 4-22 ”匿名 枚 举 

%module Unix 

/* 匿名 枚 举 */ 

enum { ONE = 1, TWO = 2, THREE, FOUR }; 


SWIG 在 <Module>Constants Java 接口 中 为 每 个 枚 举 生成 final 静态 变量 ， 如 程序 清 
单 4-23 所 示 。 像 常量 一 样 ， 也 可 以 生成 运行 库 枚 举 。 用 %javaconst 预 处 理 指令 可 以 生成 编 
译 时 枚 举 。 
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程序 清单 4-23 ”通过 常量 接口 展示 的 匿名 枚 举 


package com.apress.swig; 
public interface UnixConstants { 


public final static int ONE = UnixJNI.ONE get(); 
public final static int TWO = UnixJNI.TWO get(); 
public final static int THREE = UnixJNI.THREE get(); 
public final static int FOUR = UnixJNI.FOUR get(); 

} 


2. 类 型 -安全 
命名 枚 举 可 以 在 接口 文件 中 声明 ， 如 程序 清单 4-24 所 示 。 和 匿名 枚 举 不 同 , 命名 枚 举 
展示 给 Java 的 是 类 型 -安全 枚 举 。 


程序 清单 4-24 ”命名 枚 举 

%module Unix 

/* 命名 术 举 */ 

enum Numbers { ONE = 1, TWO = 2, THREE, FOUR }; 

SWIG 用 枚 举 名 定义 了 一 个 单独 的 类 ， 对 应 的 枚 举 值 被 展示 为 final 静态 成 员 域 ， 如 程 
序 清单 4-25 所 示 。 

程序 清单 4-25 ”展示 为 Java 类 的 命名 枚 举 


package com.apress.swig; 


public final class Numbers { 
public final static Numbers ONE = new Numbers 
("ONE", UnixJNI.ONE get()); 
public final static Numbers TWO = new Numbers( 
"TWO", UnixJNI.TWO get()); 
public final static Numbers THREE = new Numbers ("THREE"); 
public final static Numbers FOUR = new Numbers ("FOUR"); 


/* Helper 方法 . */ 


} 


这 类 枚 举 允 许 做 类 型 检查 ， 而 且 它 比 基 于 常量 的 方法 更 安全 ， 尽 管 它 可 能 不 在 switch 
语句 中 使 用 。 


3. 类 型 -不 安全 
第 三 种 方法 是 前 两 种 方法 的 组 合 。 枚 举 类 型 被 封装 在 它 所 在 的 类 中 ， 但 是 枚 举 值 以 静 
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态 final 变量 的 形式 展示 。 可 以 通过 包含 enqumtypeunsafe.swg 文件 将 命名 枚 举 标 记 为 类 型 - 
不 安全 枚 举 ， 如 程序 清单 4-26 所 示 。 


程序 清单 4-26 ”展示 为 类 型 不 安全 的 命名 枚 举 
%module Unix 

/* 类 型 不 安全 */ 

Sinclude "enumtypeunsafe.swg" 


/* 命名 枚 举 . */ 


enum Numbers { ONE = 1, TWO = 2, THREE, FOUR }; 


为 枚 举 生成 的 Java 类 如 程序 清单 4-27 所 示 。 由 于 这 个 枚 举 的 类 型 是 基于 常量 的 ， 所 
以 可 以 用 于 switch 语句 中 。 


程序 清单 4-27 ”展示 为 Java 类 的 类 型 不 安全 枚 举 


package com.apress.swig; 


public final class Numbers { 
public final static int ONE 
public final static int TWO UnixJNI.TWO get(); 
public final static int THREE = UnixJNI.THREE get(); 
public final static int FOUR = UnixJNI.FOUR get(); 


UnixJNI.ONE get(); 


} 

4. Java 枚 举 

命名 枚 举 也 可 以 作为 恰当 的 Java 枚 举 展示 到 Java 中 。 这 类 枚 举 要 做 类 型 检查 ， 而 且 
也 可 用 于 switch 语句 中 。 可 以 通过 包含 enums.swg 扩展 名 把 命名 枚 举 标记 为 Java 枚 举 ， 如 
程序 清单 4-28 所 示 。 

程序 清单 4-28 Java 枚 举 

%module Unix 

/* Java 枚 举 */ 

Sinclude "enums.swg" 


/* 命名 枚 举 .*/ 


enum Numbers { ONE = 1, TWO = 2, THREE, FOUR }; 
生成 的 Java 类 如 程序 清单 4-29 所 示 。 
程序 清单 4-29 生成 的 Java 枚 举 类 


package com.apress.swig; 


public enum Numbers { 
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ONE (UnixJNI.ONE get()), 
TWO (UnixJNI.TWO get())， 
THREE, 

FOUR; 


/* Helper 方法 . */ 


结构 体 广泛 应 用 于 C/C++ 应 用 程序 中 ， 它 们 将 一 组 命名 变量 整合 成 单一 的 数据 类 型 。 
4.4.5 ”结构 体 


SWIG 也 支持 结构 体 。 可 以 在 接口 文件 中 声明 结构 体 ， 如 程序 清单 4-30 所 示 。 
程序 清单 4-30 ”在 接口 文件 中 声明 的 Point 结构 体 


%module Unix 


/* Point 结构 体 ，*/ 
struct Point { 

int x; 

int y; 
}; 


它们 和 成 员 变量 的 getters 方法 及 setters 方法 一 起 封装 为 Java 类 ， 如 程序 清单 4-31 


程序 清单 4-31 生成 的 Point Java 类 


package com.apress.swig; 


public class Point { 
private long swigCPtr; 
protected boolean swigCMemOwn; 


protected Point (long cPtr, boolean cMemoryOwn) { 
swigCMemOwn = cMemoryOwn; 
swigCPtr = cPtr; 

} 


protected static long getCPtr (Point obj) { 
return (obj == null) ? 0 : obj.swigCPtr; 
} 


protected void finalize() { 
delete(); 
} 
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public synchronized void delete() { 
if (SwigCPtr ! = 0) { 
if (swigCMemOwn) { 
swigCMemOwn = false; 
UnixJNI .delete Point (swigCPtr); 
} 
swigCPtr = 0; 
} 


public void setX(int value) { 
UnixJNI.Point x set(swigCPtr, this, value); 


public int getx() { 
return UnixJNI.Point x get(swigCPtr, this); 


public void setY(int value) { 
UnixJNI.Point y set(swigCPtr, this, value); 


public int getY() { 
return UnixyJNI.Point y get(swigCPtr, this); 


public Point() { 
this (UnixJNI.new Point(), true); 


} 

另 一 个 广泛 使 用 的 C/C++ 数据 类 型 是 指针 ， 它 是 一 个 内 存 地 址 ， 其 值 直 接 指 向 内 存 中 
另 一 个 地 址 的 值 。 
4.4.6 指针 


SWIG 也 支持 指针 。 如 前 面 的 示例 程序 所 示 ，SWIG 存储 的 是 Java 类 中 实际 的 C 语言 
结构 体 实例 的 C 指针 。SWIG 用 long 数据 类 型 来 存储 指针 。 它 通过 使 用 finalize 方法 管理 
C 语言 组 件 的 生存 期 ， 该 C 语言 组 件 的 生存 期 与 相关 Java 类 的 生存 期 是 一 致 的 。 


4.5 封装 C++ 代码 


第 4.4 节 学 习 了 封装 C 组 件 的 基本 知识 ， 现 在 来 学 习 封 装 C++ 代码 。 首 先 ， 需 要 修改 
Android.mk 文件 以 使 SWIG 生成 C++ 代码 。 在 Editor 视图 下 打开 Android.mk 文件 ， 并 设 
置 MY_SWIG_TYPE 变量 为 cxx， 如 程序 清单 4-32 所 示 。 
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程序 清单 4-32 ”Android.mk 指导 SWIG 生成 C++ 代码 


MY _SWIG_PRCKRGE := com.apress.swig 
MY SWIG INTERFACES := Unix.i 
MY SWIG TYPE := cxx 


现在 SWIG 生成 的 是 C++ 封装 器 而 不 是 C 语言 的 代码 。 我 们 已 经 学 习 了 函数 生成 , 现 
在 要 重点 学 习 传 给 这 些 函 数 的 参数 类 型 。 


4.5.1 指针 、 引 用 和 值 


在 C/C++ 中 ， 函 数 可 以 用 许多 不 同 的 方法 传递 参数 ， 比 如 通过 指针 、 引 用 或 是 直接 传 
值 (如 程序 清单 4-33 所 示 )。 

程序 清单 4-33” 带 有 不 同 参数 类 型 的 函数 

/* 通过 指针 。*/ 


void drawByPointer(struct Point* p); 


/* 通过 引用 */ 

Void drawByReference(struct Point& p); 
/* 通过 值 */ 

void drawByValue (struct Point p); 


Java 中 没有 这 些 类 型 ，SWIG 在 封装 代码 中 把 这 些 类 型 统一 封装 为 对 象 实例 引用 ， 如 
程序 清单 4-34 所 示 。 


程序 清单 4-34 ”在 生成 的 Java 类 中 统一 方法 


package com.apress.swig; 


public class Unix implements UnixConstants { 


public static void drawBYPointer (Point p) { 
UnixJNI.drawBYPointer (Point.getCPtr (p), p); 
} 


public static void drawBYReference (Point p) { 
UnixJNI.drawBYReference (Point .getCPtr (p), p); 
} 


public static void drawByValue (Point p) { 
UnixJNI .drawByValue (Point .getCPtr (p), p); 
} 
} 


尽管 在 C 语言 中 声明 不 同 ， 程 序 清单 4-35 中 列 出 来 的 所 有 调用 都 是 正确 基于 生成 代 
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码 的 。 
程序 清单 4-35 ”用 相同 的 参数 类 型 一 致 地 调用 方法 
Point p; 
ai av ypointer (p); 


Unix.drawByReference (p); 
Unix.drawByValue (p); 


C/C++ 编程 语言 允许 函数 为 它们 的 部 分 参数 指定 默认 参数 值 。 如 果 调 用 这 些 函 数 时 省 
略 参数 ， 就 使 用 默认 值 。 


4.5.2 ”默认 参数 

尽管 Java 中 不 支持 默认 参数 ，SWIG 通过 为 每 个 默认 参数 生成 附加 函数 来 支持 有 默认 
参数 的 函数 。 带 默认 参数 的 函数 可 以 在 接口 文件 中 声明 ， 如 程序 清单 4-36 所 示 。 

程序 清单 4-36 接口 文件 中 带 默认 参数 的 函数 


%module Unix 


/* 带 默 认 参数 的 函数 ，*/ 


void func(int a = 1, int b = 2, int c = 3); 
生成 的 附加 函数 将 通过 模块 Java 类 展示 ， 如 程序 清单 4-37 所 示 。 


程序 清单 4-37 ”生成 支持 默认 参数 的 附加 函数 


package com.apress.swig; 


public class Unix { 


public static void func(int a, int b, int c) 
UnixyJNI.func SWIG 0(a, b, c); 


public static void func(int a, int b) { 
UnixyJNI.func SWIG l(a, b); 


public static void func(int a) { 
UnixyJNI.func SWIG 2(a); 


public static void func() { 
UnixyJNI.func SWIG 3(); 
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函数 重 载 允许 应 用 程序 定义 多 个 具有 相同 名 字 但 不 同 参数 的 函数 。 
4.5.3 ” 重 载 函数 


由 于 Java 已 经 提供 了 对 重 载 函数 的 支持 ,所 以 SWIG 可 以 很 轻易 地 支持 重 载 函 数 。 重 
载 函数 可 以 在 接口 文件 中 声明 ， 如 程序 清单 4-38 所 示 。 

程序 清单 4-38 ”在 接口 文件 中 声明 重 载 函数 

%module Unix 

/* 重 载 函 数 、*/ 

void func (double qd); 

void func (int i); 


SWIG 通过 模块 Java 类 展示 重 载 函 数 ， 如 程序 清单 4-39 所 示 。 


程序 清单 4-39 ”通过 模块 Java 类 展示 重 载 函数 


package com.apress.swig; 
public class Unix { 


public static void func(double d) { 
UnixJNI.func SWIG 0(d); 
} 


public static void func(int i) { 
UnixyJNI.func SWIG 1(i); 
} 


SWIG 通过 消除 歧义 的 模式 来 解决 重 载 函数 问题 ， 该 模式 按照 一 组 类 型 优先 规则 对 声 
明 进 行 分 级 和 排序 。 除 了 函数 和 基本 数据 类 型 ，SWIG 也 可 以 翻译 C++ 类 。 


4.5.4 类 


与 结构 体 类 似 ， 类 也 被 封装 成 Java 类 。SWIG 为 所 有 的 公共 类 变量 生成 必要 的 getter 
和 setter 方法 。 类 可 以 在 接口 文件 中 声明 ， 如 程序 清单 4-40 所 示 。 
程序 清单 4-40 ”接口 文件 中 的 类 声明 
%module Unix 
和 * 美 ax/ 
class RAR { 
public: 


及 () 7 
Al(lint value); 
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~R(O7 
void Print() 7 


int Value 
private: 
void reset(); 
] 7 
SWIG 生成 相应 的 Java 类 ， 如 程序 清单 4-41 所 示 。 值 成 员 变量 是 公共 的 ，SWIG 自动 
生成 相应 的 getter 和 setter 方法 。 因 为 reset 方法 在 类 声明 中 被 定义 为 私有 的 ， 因 此 它 没有 


被 展示 到 Java 中 。 


程序 清单 4-41 C/C++ 展示 到 Java 


package com.apress.swig; 


public class A { 
private long swigCPtr; 
protected boolean swigCMemOwn; 
protected A(long cPtr, boolean cMemoryOwn) { 
swigCMemOwn = cMemoryOwn; 
swigCPtr = cPptr; 
} 


protected static long getCPtr(R obj) { 
return (obj == null) ? 0 : obj.swigCPtr; 


} 


protected void finalize() { 
delete(); 
} 


public synchronized void delete() { 
if (swigCPtr ! = 0) { 
if (swigCMemOwn) { 
swigCMemOwn = false; 
UnixJNI.delete Al(swigCPtr); 
} 
swigCPtr = 07 
} 
} 


public A() { 
this (UnixJNI.new A SWIG 0(), true); 


} 


public Al(int value) { 
this (UnixJNI.new A SWIG 1(value), true); 


} 
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public void print() { 
UnixJNI.A print (swigCPtr, this); 
} 


public void setValue (int value) { 
UnixJNI.A value set (swigCPtr, this, value); 
} 


public int getValue() { 
return UnixJNI.A value get (swigCPtr, this); 
} 
} 


SWIG 也 支持 继承 。 被 封装 到 有 层次 关系 的 Java 类 中 的 这 些 类 在 C++ 中 也 具有 相同 的 
继承 关系 。 由 于 Java 不 支持 多 继承 ， 任 何 多 继承 的 C++ 类 在 代码 生成 阶段 都 会 产生 错误 。 


4.6 ”异常 处 理 


在 原生 代码 中 ，C/C++ 函 数 能 够 抛 出 异常 或 者 返回 错误 代码 。SWIG 允许 开发 人 员 通 
过 使 用 %exception 预 处 理 指令 将 C/C++ 异常 和 错误 转换 成 Java 异常 , 进而 将 异常 处 理 代 码 
引入 生成 的 封装 代码 中 。 蜡 常 处 理 代码 可 以 在 接口 文件 中 定义 ， 如 程序 清单 4-42 所 示 。 异 
常 处 理 代 码 应 该 在 实际 函数 声明 前 定义 。 


程序 清单 4-42 getuid 函数 的 异常 处 理 代码 
/* getuid 函数 的 异常 处 理 */ 


g%exception getuid { 
$action 
if (!result) { 
jclass clazz = jenv->FindClass ("java/lang/OutOfMemoryError"); 
jenv->ThrowNew (clazz, "Out of Memory"); 
return $null; 
} 
} 


/* 请 求 SWIG 封装 getuid 函数 */ 


extern uid t getuid(void); 

与 程序 清单 4-11 相 比 ， 生 成 的 getuid 函数 封装 器 代码 如 程序 清单 4-43 所 示 。 

程序 清单 4-43 ” 带 异常 处 理 的 封装 代码 

SWIGEXPORT jlong JNICALL Java_com_apress_swig_UnixJNI_getuid(JNIEnV *jenv, 
jclass jcls) { 


jlong jresult = 0 
uid t result; 
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(void)jenvz 
(void)jcls; 
并 
result = (uid t)getuid() 7 
if (!result) { 
jclass clazz = jenv->FindClass ("java/lang/OutOfMemoryError"); 
jenv- > ThrowNew (clazz, "Out of Memory"); 
return 0; 
} 
} 
jresult = (jlong)result; 
return jresult; 


} 

由 于 代码 抛 出 了 一 个 运行 库 异常 ， 生 成 的 Java 代码 没有 改变 。 如 果 抛 出 一 个 检查 的 异 
常 ，SWIG 可 以 通过 %javaexception 预 处 理 指令 做 出 反应 并 生成 相应 的 Java 方法 ， 如 程序 
清单 4-44 所 示 。 


程序 清单 4-44 告诉 SWIG 可 能 抛 出 一 个 检查 异常 
/* getuid 的 异常 处 理 */ 


%Jjavaexception("java.lang.I1legalAccessEXCception") getuid { 
$action 
if (!result) { 
jclass clazz = jenv->FindCclass ("java/lang/IllegalAccessException"); 
jenv->ThrowNew (clazz, "Illegal Access"); 
return $null; 
} 
》 


现在 生成 的 Java 方法 签名 表明 可 能 抛 出 检查 异常 ， 如 程序 清单 4-45 所 示 。 


程序 清单 4-45 ”表明 抛 出 异常 的 Java 类 


package com.apress.swig; 


public class Unix { 
public static long getuid() throws java.lang.IllegalAccessException { 
return UnixJNI.getuid(); 
} 
} 


4.7 ”内 存 管理 


SWIG 生成 的 每 一 个 代理 类 都 包含 一 个 名 为 swigCMemOwan 的 所 有 权 标志 。 这 个 标志 
指定 谁 负责 清理 底层 C/C++ 组 件 。 如 果 底 层 组 件 属 于 这 个 代理 类 ， 回 收 机 制 通过 Java 类 的 
finalize 方法 来 释放 内 存 ， 也 可 以 不 用 等 待 回收 机 制 而 直接 调用 Java 类 的 删除 方法 来 释放 
内 存 。 在 运行 期 间 ，Java 类 可 以 通过 swigReleaseOwnership 释放 C/C++ 底层 组 件 的 内 存 所 
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有 权 、 通 过 swigTakeOwnership 方法 取得 C/C++ 底层 组 件 的 内 存 所 有 权 。 


4.8 从 原生 代码 中 调用 Java 


目前 为 止 ， 学 习 了 各 种 从 Java 中 调用 C/C++ 代码 的 方法 。 在 某 些 情况 下 ， 也 需要 在 
C/C++ 代码 反 过 来 调用 Java 代码 , 例如 回调 。SWIG 也 支持 使 用 虚拟 方法 在 C/C++ 代码 调 
用 Java 代码 。 


4.8.1 异步 通信 


为 了 演示 这 一 流程 ， 需 要 把 getuid 函数 调用 封装 到 一 个 C/C++ 类 并 通过 一 个 回调 返回 
它 的 结果 ， 从 而 将 getuid 函数 调用 转换 成 异步 模式 。 为 了 这 个 实验 ， 可 以 将 类 声明 和 类 定 
义 放 到 SWIG 接口 文件 中 ， 如 程序 清单 4-46 所 示 。 

程序 清单 4-46 AsyncUidProvider 类 的 定义 和 声明 

%module Unix 

2 sa 

/* Rsynchornous user ID 提供 者 */ 

class AsyncUidProvider { 


public: 
AsyncUidProvider() { 


Virtual ~ AsyncUidProvider() { 


void get() { 
onUid (getuid()); 


Virtual void onUid(uid t uid) { 


]} 
%} 


/* Asynchornous user ID provider. */ 
class AsyncUidProvider { 
public: 

AsyncUidProvider ()7 

Virtual ~ AsyncUidProvider(); 


void get(); 
Virtual void onUid(uid t uid); 
}; 
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4.8.2 启用 Directors 


SWIG 用 directors 特征 提供 对 交叉 语言 多 态 性 的 支持 。 默 认 情 况 下 ， 该 特性 是 禁用 的 ， 
为 了 启用 这 一 特征 ,需要 修改 %module 预 处 理 指令 让 它 包含 directors 标志 .在 启用 directors 
功能 之 后 ， 要 用 %feature 预 处 理 指令 将 特征 应 用 于 AsyncUidProvider 中 ， 两 处 修改 请 见 程 
序 清单 4-47。 

程序 清单 4-47 ”开启 Directors 扩展 并 应 用 该 特征 
/* 模块 名 为 Unix. */ 


%module (directors = 1) Unix 


/* 启用 AsyncUidProvider 的 directors */ 
%feature ("director") AsyncUidProvider; 


为 了 能 够 从 C/C++ 代码 中 调用 Java 代码 , directors 扩展 依赖 于 编译 器 的 运行 库 类 型 信 
息 特 征 (RTTI，Run-Time Type Information)。 


4.8.3 启用 RTTI 


默认 情况 下 ，Android NDK 构建 系统 中 RTTI 是 关闭 的 。 为 了 启用 它 ， 按 照 程 序 清 
单 4-48 所 示 的 内 容 修 改 Android.mk 文件 。 


程序 清单 4-48 ”启用 Android.mk 文件 中 的 RTTI 


# 启用 RTTI 
LOCAL CPP FEATURES + = rtti 


现在 原生 代码 部 分 已 经 准备 好 了 ， 在 项 部 菜单 中 单 击 Project | Build All 重新 构建 当前 
项 目 。 
4.8.4” 重 写 回调 方法 

在 Java 端 , 需要 对 展示 的 AsyncUidProvider 类 进行 扩展 ,并 重 写 onUid 方法 来 接收 getuid 
函数 调用 的 返回 值 ， 如 程序 清单 4-49 所 示 。 


程序 清单 4-49 在 Java 中 扩展 AsyncUidProvider 


package com.example.hellojni; 
import android.widget.TextView; 
import com.apress.swig.AsyncUidProvider; 


public class UidHandler extends AsyncUidProvider { 
private final TextView textView; 
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UidHandler (TextView textView) { 
this .textView = textView; 


} 


QOverride 

public void onUid(long uid) { 
textView.setText ("UID: " + uid); 

和 


4.8.5 更 新 HelloJni Activity 


最 后 一 步 , 修改 HelloJni Activity 以 使 用 UidHandler 类 。onCreate 方法 中 需要 修改 的 内 
容 如 程序 清单 4-50 所 示 。 


程序 清单 4-50 ”用 新 的 UidHandler 类 修改 onCreate 方法 


override 
public void onCreate (Bundle savedInstanceState) 


{ 


TextView tv = new TextView(this) 
setContentView (tv); 


UidHandler uidHandler = new UidHandler (tv); 
uidHandler.get (); 
} 
在 主 菜单 中 单 击 New | File 来 打开 这 个 应 用 程序 , 调用 AsnycUidProvider 类 的 get 方法 
时 ，C/C++ 代 码 用 getuid 函数 调用 的 返回 结果 回调 Java 并 且 显示 调用 结果 。 


4.9 小 结 


正如 你 所 见 , SWIG 通过 生成 必要 的 JNI 封 装 代 码 简 化 了 原生 代码 与 Java 层 之 间 的 连 
接 过 程 。 尽 管 这 个 过 程 对 开发 人 员 是 高 度 透 明 的 ，SWIG 仍然 支持 让 开发 人 员 对 生成 的 代码 
进行 扩展 以 满足 他 们 的 个 性 化 需求 的 必要 功能 。 关 于 SWIG 的 更 多 资料 请 登录 http://swig.org/ 
Doc2.0/index.html 查找 SWIG 文档 。 在 下 面 的 章节 中 将 继续 学 习 SWIG 的 其 他 特征 并 且 经 
常会 使 用 SWIG。 
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第 章 


日 志 、 调 试 及 故障 处 理 


第 4 章 学 习 了 Android NDK 构建 系统 以 及 用 JNI 技 术 连 接 原生 代码 与 Java 应 用 程序 的 
方法 。 毋 庸 置疑 ， 学 习 新 平台 上 的 应 用 程序 开发 需要 花 很 多 的 时 间 做 实验 。 在 用 提供 的 原 
生 API 做 实验 之 前 ， 掌 握 Android 平台 的 故障 排除 技术 是 至 关 重 要 的 ， 因 为 它 可 以 帮助 我 
们 快速 发 现 问题 ， 从 而 加 快 学 习 进 度 。 因 为 Android 应 用 程序 的 开发 和 执行 在 不 同 的 机 器 
上 进行 ， 因 此 不 能 直接 使 用 现 有 的 故障 排除 技术 。 本 章 将 学 习 日 志 、 调 试 和 故障 排除 工具 
及 技术 ， 主 要 内 容 包括 : 

e Android 日 志 框 架 概述 
用 Eclipse 和 命令 行 方 式 调试 原生 代码 
在 机 器 崩溃 时 分 析 栈 跟踪 
用 CheckJNI 模式 尽早 发 现 故 障 
用 libc 和 Valgrind 处 理 内 存 相关 故障 
用 strace 监控 原生 代码 执行 情况 


5.1 日 志 


日 志 是 故障 处 理 中 最 重要 的 部 分 ， 但 是 它 难 以 实现 ， 特 别 是 在 那些 使 用 两 个 不 同 的 机 
器 进行 开发 和 执行 的 移动 平台 上 。Android 有 一 个 扩展 日 志 框架 ,用 于 对 系统 范围 内 Android 
系统 本 身 的 信息 及 应 用 程序 的 信息 集中 做 日 志 。 它 还 提供 了 一 组 用 户 级 应 用 程序 以 查看 和 
过 滤 这 些 日 志 ， 如 logcat 和 Dalvik 调试 监视 服务 器 (DDMS,， Dalvik Debug Monitor Server) 
工具 。 


5.1.1 框架 


Android 日 志 框架 是 名 字 为 logger 的 内 核 模块 。 随 时 随地 地 对 平台 上 的 任何 信息 进行 
日 志 会 产生 大 量 信息 ， 从 而 使 得 查看 和 分 析 这 些 日 志 变 得 非常 困难 。 为 了 简化 这 个 过 程 ， 
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Android 日 志 框架 把 日 志 消息 分 成 4 个 日 志 缓 冲 区 : 

e Main: 主要 应 用 程序 的 日 志 信息 

e Event: 系统 事件 

。 Radio: Radio 相关 的 日 志 信息 

e System: 调试 时 产生 的 低级 系统 调试 信息 

这 4 个 缓冲 区 以 伪 设 备 的 形式 保存 在 /dewlog 系统 目录 下 。 因为 移动 平台 上 的 IO 操作 
代价 很 大 ， 所 以 日 志 信息 要 保存 在 内 存 中 ， 而 不 能 保存 在 永久 性 存储 器 (例如 磁盘 ) 中 。 为 
了 有 效 控制 对 存储 日 志 信息 的 内 存 空间 的 利用 ，logger 模块 把 日 志 信息 放 在 固定 大 小 的 组 
冲 区 。Main、radio 和 system 日 志 以 自由 文本 的 格式 保存 在 64KB 的 日 志 绥 在 区 中 。 事 件 
日 志 信 息 带 有 额外 的 二 进 制 形式 信息 ， 因 此 保存 在 256KB 的 日 志 缓存 区 中 。 


5.1.2 ”原生 日 志 API 


开发 者 不 希望 直接 与 logger 内 核 模 块 进行 交互 。Android 运行 库 系 统 提供 了 一 组 API 
调用 以 便于 Java 代码 和 原生 代码 向 logger 内 核 模块 发 送 日 志 信息 。 通 过 android/log.h 头 文 
件 来 展示 原生 代码 的 日 志 API。 为 了 使 用 日 志 函 数 ， 原 生 代码 需要 先 包含 该 头 文件 。 

#include <android.h> 

除了 要 包含 合适 的 头 文件 , 还 需要 动态 修改 Android.mk 文件 从 而 将 原生 模块 与 日 志 库 
进行 链接 ， 可 以 通过 使 用 构建 系统 变量 LOCAL LDLIBS 完成 该 操作 ， 如 程序 清单 5-1 所 
示 。 该 构建 系统 变量 必须 被 放 在 共享 库 构 建 片段 的 include 语句 之 前 ;否则 它 将 不 起 作用 。 

程序 清单 5-1 “动态 链接 原生 模块 与 日 志 库 


LOCAL MODULE:=hello-jni 
LOCAL LALIBS+=-llog 


ee (BUILD_ SHARED LIBRARY) 

1. 日 志 消 息 

通过 日 志 API 发 送 给 logger 模块 的 每 个 日 志 条 目 都 具有 以 下 字段 : 

e Priority: 取 值 分 别 为 verbose、debug、info、warming、error 和 fatal， 表 示 日 志 信 


息 的 重要 程度 。 支 持 的 日 志 优先 级 在 android/log.h 头 文件 中 声明 ， 如 程序 清单 5-2 
所 示 。 


程序 清单 5-2 ”支持 的 日 志 优先 级 


typedef enum android LogPriority { 


ANDROID LOG VERBOSE, 
ANDROID LOG DEBUG, 
ANDROID LOG INFO, 
ANDROID LOG WARN, 
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ANDROID LOG _ ERROR， 
RNDROID LOG FATAL, 


} android LogPriority; 


e Tag: 标识 产生 日 志 信 息 的 组 件 ，Logcat 和 DDMS 工具 可 以 基于 这 个 标签 值 过 滤 
日 志 信息 。 标 签 值 应 该 尽 可 能 小 。 

。 Message: 用 于 存放 实际 日 志 信息 。 在 每 一 个 日 志 消 息 后 自动 追加 一 个 换行 符 ， 因 
为 循环 的 日 志 缓存 区 很 小 ， 因 此 强烈 建议 应 用 程序 的 日 志 信息 大 小 尽量 保持 合适 。 


2. 日 志 函 数 


android/log.h 头 文件 也 声明 了 一 系列 函数 ， 这 些 函数 主要 用 于 原生 代码 生成 日 志 消息 。 
e _android log write: 可 用 于 生成 一 个 简单 的 字符 串 作为 日 志 信息 。 如 程序 清单 5-3 
所 示 ， 它 包括 日 志 优先 级 、 日 志 标签 和 日 志 消息 。 


程序 清单 5-3 ”生成 简单 的 日 志 消息 


_android log write (ANDROID LOG WARN,"hello-jni","warning 10g."); 


e _android_log_print: 可 用 于 生成 一 个 格式 化 字符 串 作为 日 志 消 息 。 它 包括 日 志 优先 
级 、 日 志 标签 、 字 符 串 格 式 和 格式 中 指定 个 数 的 其 他 参数 ， 如 程序 清单 5-4 所 示 。 
请 查阅 ANSIC printf 文档 了 解 格式 化 字符 串 的 语法 。 


程序 清单 5-4 ”生成 格式 化 的 日 志 消息 

_android log print (ANDROID LOG ERROR, "hello-jni", 
"Failed with errno %d",erron); 

。 _android_log_vprint: 除了 参数 传递 方式 外 ， 其 他 功能 与 android_log_print 函数 完 
全 相同 ，_android_log_vprint 函数 用 va_list 传递 附加 参数 ， 而 _android_log_print 函 
数 中 以 连续 参数 的 方式 改 为 传递 参数 。 如 果 想 要 调用 日 志 函 数 时 传递 给 当前 函数 
的 参数 个 数 动态 变化 时 ， 该 函数 的 优势 就 会 体现 出 来 ， 如 程序 清单 5-5 所 示 。 


程序 清单 5-5 ”传递 的 参数 个 数 变化 时 生成 日 志 消息 


void 1og_Vverbose (const char* format,...) 


{ 


va list args; 


va_start (args, format); 
_android log vprint (ANDORID LOG VERBOSS,"hello-jni",format,args); 
va_end (args)7 


} 


Void example() 
. 


log verbose("Errno is now %d",errno); 


} 
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e _android_log_assert: 用 于 记录 断言 失败 。 与 其 他 的 日 志 函 数 比 较 ， 它 不 包括 日 志 
优先 级 ， 但 总 是 将 所 有 的 日 志 记录 为 fatal， 如 程序 清单 5-6 所 示 。 如 果 附 加 了 调试 
器 ， 它 也 SIGTRAP 当前 进程 以 通过 debugger 进一步 检查 。 


程序 清单 5-6 ”生成 断言 失败 日 志 


if(0!=erron) 
{ 

_android log assert("0!=errno","hello-jni","There is an error."); 
} 


5.1.3” 受 控制 的 日 志 


与 Java 中 的 对 应 部 分 一 样 ， 原 生 的 日 志 API 只 允许 用 户 向 日 志 内 核 模块 发 出 日 志 
息 ， 在 现实 生活 中 ， 在 发 行 和 调试 构建 时 你 既 不 会 用 断言 也 不 会 以 相同 的 间隔 做 日 志 。i 
憾 的 是 ，Android 日 志 API 不 提供 任何 基于 优先 级 的 日 志 消 息 压缩 机 制 。 它 没有 Log4J 
或 Log4CXX 等 其 他 日 志 框架 那样 先进 。 Android 日 志 框架 假设 你 将 在 新 发 布 的 版 本 中 除去 
不 必要 的 日 志 信息 。 尽 管 在 Java 应 用 程序 中 使 用 Proguard 很 容易 做 到 这 一 点 , 但 是 在 原生 
代码 中 却 难以 实现 。 


1. 日 志 包装 器 


本 节 介绍 关于 上 述 问题 的 基于 预 处 理 器 的 解决 方案 。 为 此 我 们 修改 以 前 导入 的 hello-jni 
原生 项 目 ， 打 开 Eclipse， 在 Project Explorer 菜单 项 上 右 击 jni 子 目录 。 在 上 下 文 菜单 上 ， 
选择 New Header File 打开 创建 头 文件 对 话 框 。 将 头 文件 名 字 设 置 为 my_log.h， 单 击 Finish 
按钮 继续 。my_log.h 头 文件 的 内 容 显示 在 程序 清单 5-7 中 。 


程序 清单 5-7 my_log.h 头 文件 的 内 容 


#pragma once 

/* 大 

* NDK 的 基本 日 志 框 架 . 
* 


* @ 作 者 Onur Cinar 
$y 


#include <android/log.h> 


#define MY LOG LEVEL VERBOSE 1 
#define MY LOG LEVEL DEBUG 2 


#define MY LOG LEVEL INFO 3 
#define MY LOG LEVEL WARNING 4 


#define MY LOG LEVEL ERROR 5 


#define MY LOG LEVEL FATAL 6 


#define MY LOG LEVEL SILENT 7 


#ifndef MY LOG TAG 
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# define MY LOG TAG FIIE 
#endif 


#ifndef MY LOG LEVEL 
# define MY LOG LEVEL MY LOG LEVEL VERBOSE 
#endif 


#define MY LOG NOOP (void) 0 


#define MY LOG PRINT(level,fmt,...) \ 
__android log print (level, MY LOG TAG, "(%s:%u) %s: " fmt, \ 
_FILE , LINE , PRETTY FUNCTION ，, 振 VA RRGS ) 


#if MY LOG LEVEL VERBOSE >= MY LOG LEVEL 
# define MY LOG VERBOSE (fmt,...) \ 
MY_LOG_PRINT (ANDROID LOG VERBOSE, fmt, 持 VA ARGS ) 
#else 
# define MY LOG VERBOSE(...) MY _ LOG NOOP 
#endif 


#if MY LOG LEVEL DEBUG >= MY LOG LEVEL 
# define MY LOG DEBUG(fmt,...) \ 
MY_LOG PRINT (ANDROID LOG_DEBUG，fmt，## VA ARGS ) 
#else 
# define MY LOG DEBUG(...) MY LOG NOOP 
#endif 


#if MY LOG LEVEL INFO >= MY_ LOG LEVEL 
# define MY LOG INFO(fmt,...) \ 
MY_LOG PRINT (ANDROID LOG_INFO，fmt，## VA ARGS ) 
#else 
# define MY LOG INFO(...) MY LOG NOOP 
#endif 


#if MY LOG LEVEL WARNING >= MY _LOG LEVEL 
# define MY LOG WARNING (fmt,...) \ 
MY_LOG_ PRINT (ANDROID LOG WARN, fmt，## VA ARGS ) 
#else 
# define MY LOG WARNING(...) MY LOG NOOP 
#endif 


#if MY LOG LEVEL ERROR >= MY LOG LEVEL 
# define MY LOG ERROR(fmt,...) \ 
MY_LOG PRINT (ANDROID LOG _ERROR，fmt，## VA ARGS ) 
#else 
# define MY LOG ERROR(...) MY LOG NOOP 
#endif 


#if MY LOG LEVEL FATAL >= MY LOG LEVEL 
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大 define MY LOG FATAL(fmt,...) \ 
MY _ LOG PRINT (ANDROID LOG FATAL, fmt, ## VA ARGS ) 
#else 
# define MY LOG FATAL(...) MY LOG NOOP 
#endif 


#if MY LOG LEVEL FATAL >= MY LOG LEVEL 


非 define MY LOG ASSERT (expression, fmt, ...) \ 
if (!(expression)) \ 
人 


__android log assert (#expression, MY LOG TAG, \ 
fmt, ## VA ARGS ); \ 
} 

#else 

# define MY LOG ASSERT(...) MY LOG NOOP 

#endif 

my_log.h 头 文件 通过 一 系列 预 处 理 程序 指令 为 原生 代码 定义 了 一 个 基本 的 日 志 框架 。 

这 些 预 处 理 程序 指令 包括 Android 日 志 函 数 并 允许 它们 在 编译 时 被 触发 。 


2. 增加 日 志 


现在 可 以 将 日 志 声 明 加 入 到 原生 代码 中 ， 在 Project Explorer 视图 中 双击 hello-jni.c 源 
文件 ， 并 在 Editor 视图 中 打开 该 文件 。 为 了 使 用 基本 的 日 志 框 架 ， 需 要 先 包 含 my_log.h 头 
文件 。 不 需要 包含 android/log.h， 因 为 my_log.h 头 文件 中 已 经 包含 了 android/log.h 的 内 容 。 


#include "my_log.h" 
现在 可 以 在 原生 函数 中 添加 日 志 声 明 语 句 ， 如 程序 清单 5-8 所 示 。 
程序 清单 5-8 ”在 原生 函数 中 添加 日 志 声 明 语句 


jstring 
Java_com example hellojni HelloJni stringFromJNI( JNIEnv* env,jobject 
thiz ) 
{ 
MY LOG VERBOSE ("The stringFromJNI is called."); 
MY _ LOG DEBUG ("env=%p thiz=%p", env, thiz); 
MY LOG ASSERT(0 != env, "JNIEnv cannot be NULL."); 


MY LOG INFO("Returning a new string."); 


return (*enV) ->NewStringUTE (env, "Hello from JNI !"); 
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3. 更 新 Android.mk 


现在 可 以 更 新 Android.mk 文件 来 调整 基本 的 日 志 框 架 。 在 Project Explorer 视图 中 双击 
Android.mk 源 文件 以 在 Editor 视图 中 打开 该 文件 。 


(1) 日 志 标签 
正如 上 文 所 述 ， 每 一 个 日 志 消 息 都 包括 一 个 标识 日 志 来 源 的 标签 。 模 块 中 的 日 志 标 签 
可 以 在 Android.mk 中 定义 ， 如 程序 清单 5-9 所 示 。 
程序 清单 5-9 通过 MY_LOG_TAG 构建 变量 定义 日 志 标签 
LOCAL MODULE := hello-jni 
# 定义 日 志 标签 
MY _ LOG TAG := \"hello-jni\" 
(2) 日 志 等 级 
基本 日 志 框架 的 主要 优点 是 可 以 定义 日 志 等 级 。 因 为 发 布 版 本 和 调试 版 本 中 的 日 志 粒 
度 不 同 ， 可 以 通过 修改 Android.mk 文件 从 而 为 发 布 版 本 和 调试 版 本 定义 不 同 的 日 志 等 级 ， 
如 程序 清单 5-10 所 示 。 
程序 清单 5-10 ”定义 默认 的 日 志 等 级 
LOCAL MODULE := hello-jni 
# 定义 日 志 标签 
MY _ LOG TAG := \"hello-jni\" 
# 定义 基于 构建 类 型 的 默认 日 志 等 级 
ifeq ($(APP OPTIM) ,release) 
MY LOG LEVEL := MY LOG LEVEL ERROR 
else 


MY_LOG LEVEL := MY _ LOG LEVEL VERBOSE 
endif 


第 2 章 曾 提 到 ，APP_OTIM 构建 系统 变量 指定 了 构建 类 型 是 发 布 还 是 调试 。 基 于 变量 
APP_OPTIM 的 值 ， 将 MY_LOG _LEVEL 的 值 设置 成 匹配 的 日 志 等 级 。 


(3) 应 用 日 志 配 置 
在 定义 MY_LOG_TAG 和 MY LOG _LEVEL 构建 系统 变量 时 , 可 以 将 日 志 系 统 配置 应 
用 在 模块 中 ， 如 程序 清单 5-11 所 示 。 


程序 清单 5-11 将 日 志 系统 配置 应 用 在 模块 中 
LOCAL MODULE := hello-jni 
# 定义 日 志 标 签 


MY LOG TAG := hello-jni 
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# 定 义 基于 构建 类 型 的 默认 日 志 等 级 
ifeq ($(APP OPTIM), release) 

MY LOG LEVEL := MY LOG LEVEL ERROR 
else 

MY LOG LEVEL := MY LOG LEVEL VERBOSE 
endif 


# 追加 编译 标记 
LOCAL CFLAGS += -DMY LOG TAG=$ (MY LOG TAG) 
LOCAL CFLAGS += -DMY LOG LEVEL=$ (MY LOG LEVEL) 


# 动态 链接 日 志 库 
LOCAL LDLIBS += -llog 


4. 通过 Logcat 查看 日 志 消 息 
在 执行 hellojni 应 用 程序 时 ， 可 以 通过 Logcat 视图 查看 日 志 消 息 ， 如 图 5-1 所 示 。 


区 Problems 2 Tasks 器 Console © Properties EP logCat 2 


L | Te PiD_ [TD 
V 08-08 05:16:0 839 B39 com exarple hello-jni 


Com exarple hello-jni 


图 5-1 原生 代码 中 的 日 志 消息 
5.1.4 控制 台 日 志 


当 将 第 三 方 库 文件 或 早期 版 本 中 的 模块 集成 到 Android 应 用 程序 项 目 中 时 ， 不 可 能 将 
它们 的 日 志 机 制 改 为 Android 特定 的 日 志 。 大 多 数 的 日 志 机 人 制 或 将 日 志 消息 写 入 文件 或 者 
直接 写 入 控制 台 。 

默认 情况 下 , 控制 台 文 件 描述 符 一 一 STDOUT 和 STDERR 在 Android 平台 上 是 不 可 见 
的 。 要 想 将 这 些 日 志 消息 重 定向 到 Android 系统 日 志 中 ， 需 要 打开 一 个 命令 提示 符 或 一 个 
终端 窗口 ， 并 且 执 行程 序 清单 5-12 所 示 的 ADB 命令 。 


程序 清单 5-12 ”将 控制 台 日 志 重 定向 到 Android 系统 日 志 中 


adb shell stop 
adb shell setprop log.redirect-stdio true 
adb shell start 


在 重新 启动 应 用 程序 时 ， 用 Logcat 视图 可 以 看 到 控制 台 日 志 信 息 ， 如 图 5-2 所 示 。 
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区 Problems 本 Tasks 是 Console 局 Properties WD LogCat 32 | 
Rd vebose 品目 匠 吕 十 
Clime PID [TD 下 Te 
D 08-08 05:52:2... 2592 2532 dalvikwe Joining stdio converter- 

- 2612 2612 dalvikwe Joining stdio converter... 
~ 2623 2630 com example hellojni stdour Logging to STDOUT descripror- 


2623 2630 com.example.hellojni ~ stdezr Logging to STDERR descriptor. 


[9 加 


图 5-2 自 STDOUT 和 STDERR 描述 符 的 日 志 消 息 重 定向 


设备 重启 前 系统 将 一 直 保 存 此 设置 。 如 果 想 将 此 设置 为 默认 值 ， 需 要 将 上 述 命令 添加 
到 设备 或 模拟 器 的 /data/local.prop 文件 。 


5.2 调试 


日 志 允 许 正在 运行 的 应 用 程序 输出 消息 以 显示 程序 当前 的 状态 。 当 进行 故障 检测 时 ， 
从 相关 部 分 的 代码 中 产生 的 日 志 消 息 的 粒度 是 远 远 不 够 的 ， 需 要 将 新 的 日 志 植 入 代码 中 以 
显示 更 多 关于 它 当前 状态 的 信息 ， 但 是 这 显然 使 得 故障 诊断 速度 大 大 降低 。 用 调试 器 去 观 
察 应 用 程序 的 状态 是 最 方便 的 故障 检测 方法 。Android NDK 支持 通过 GNU 调试 器 (GDB) 
来 调试 原生 代码 。 


5.2.1 预备 知识 


为 了 调试 原生 代码 ， 必 须 满足 下 列 条 件 : 

e 可 以 在 命令 行 方 式 下 用 ndk-build 命令 或 在 Eclipse IDE 环境 下 用 Android 开发 工具 
对 原生 代码 进行 编译 。 在 构建 过 程 中 ，NDK 构建 系统 生成 一 组 文件 以 便于 进行 远 

e 通过 设置 AndroidManifestxml 文件 中 的 应 用 程序 标签 属性 android:debuggable 可 以 
将 应 用 程序 设置 成 可 调试 的 ， 如 程序 清单 5-13 所 示 。 


程序 清单 5-13 ”将 应 用 程序 声明 为 可 调试 的 


<?xml Version="1.0"” encoding="utf-8"?> 

<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.example.hellojni" 
android:versionCode="1" 
android:versionName="1.0"> 


<application android:1label="@string/app_name" 
android:debuggable="true"> 


</application> 
</manifest> 
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e 设备 和 仿真 器 需要 运行 Android 2.2 或 更 高 的 版 本 。 早期 版 本 不 支持 原生 代码 调试 。 
nkd-gdb 脚本 处 理 许多 错误 情况 并 输出 大 量 错误 信息 以 让 用 户 知道 哪些 条 件 没有 满足 。 
5.2.2 ”调试 会 话 建立 


ndk-gdb 脚本 代表 开发 人 员 设 置 调试 会 话 ， 但 同时 知道 调试 会 话 建立 期 间 事件 的 发 生 
序列 ， 这 些 序 列 有 助 于 理解 在 Android 平台 上 调试 原生 代码 的 警告 信息 。 在 调试 会 话 建立 
阶段 事件 发 生 的 完整 序列 如 图 5-3 所 示 。 

GpB client ga SI Server App 


一 开始 -二 


一 一 一 开始 应 用 程序 一 一 | 三 开始 应 用 程序 1 
等 待 2 秒 钟 1 


! 
| 一 一 一 一 一 -开始 GDB 服务 器 并 附 在 Hello_JNI 应 用 程序 上 
一 一 一 映射 调试 端口 
一 复制 调制 的 二 进 制 文件 一 ”| 
发 --- 应 用 过 程 和 共享 库 .---]| 
| 一 开始 调试 一 


图 5-3 ”调试 会 话 建立 序列 图 


ndk-gdb 脚本 用 应 用 程序 管理 器 的 ADB 打开 目标 应 用 程序 , 应 用 程序 管理 器 只 是 将 请 
求 转 给 Zygote 进程 。 

Zygote 也 被 称 为 “app 进程 ”>， 它 是 Android 系统 引导 时 启动 的 核心 进程 之 一 ， 它 在 
Android 平台 扮演 的 角色 是 启动 Dalvik 虚拟 机 并 初始 化 所 有 Android 核心 服务 。 作 为 一 个 
移动 操作 系统 ， 为 了 提供 一 个 快速 响应 的 用 户 体验 ，Android 需要 确保 应 用 程序 的 启动 时 
间 尽 量 短 。 为 此 Zygote 不 是 从 零 开始 为 应 用 程序 启动 一 个 新 进程 ,而 是 只 使 用 fork 这 一 系 
统 调用 。 在 计算 时 ，fork 是 克隆 一 个 现 有 进程 的 操作 。 尽 管 两 个 进程 都 独立 运行 ， 但 是 事 
实 上 ， 新 的 进程 复制 了 父 进程 的 所 有 内 存 片段 。 

此 时 ， 应 用 程序 已 经 启动 起 来 了 而 且 开 始 执 行 代码 。 正 如 你 看 到 的 ， 此 时 调试 会 话 仍 
然 没有 建立 。 

注意 : 

基于 Zygote 的 工作 方式 ，GDB 不 能 启动 应 用 程序 ， 但 是 它 附加 于 一 个 已 经 运行 的 应 
用 程序 进程 上 。 如 果 想 在 GDB 附加 之 前 阻止 应 用 程序 执行 代码 ， 需 要 用 Java Debugger 在 
代码 的 合适 位 置 设置 一 个 断 点 。 


在 获得 应 用 程序 的 进程 ID 时，ndk-gdb 脚本 在 Android 平台 上 启动 GDB 服务 器 并 将 
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其 附 于 运行 的 应 用 程序 上 。ndk-gdb 脚本 用 ADB 配置 转发 端口 从 而 可 以 在 主机 上 访问 GDB 
服务 器 。 然 后 ,在 启动 GDB 客户 端 之 前 , 为 Zygote 将 二 进 制 文件 和 共享 库 复制 到 主机 上 。 
在 二 进 制 文件 复制 之 后 ，ndk-gdb 脚本 启动 GDB 客户 端 ， 同 时 调试 会 话 被 激活 。 然 后 便 可 
以 开始 调试 应 用 程序 。 


5.2.3 ”建立 调试 示例 


为 了 学 习 原 生 代码 的 调试 操作 ， 需 要 用 到 hello-jni 示例 项 目 。 为 了 简化 调试 过 程 ， 需 
要 对 HelloJni Activity 的 onCreate 方法 作 一 个 小 小 的 修改 。 如 前 所 述 ， 用 Eclipse 的 Editor 
View 窗口 打开 HelloJni 活动 。 如 程序 清单 5-14 所 示 修 改 onCreate 方法 。 


程序 清单 5-14 ”修改 onCreate 方法 以 延长 原生 调用 时 间 


@Override 
public void onCreate (Bundle savedInstanceState) 


| 


Super .onCreate (savedInstanceState) 7 


Button button = new Button (this) 7 
button.setText ("Call Native"); 
button.setOnClickListener (new OnClickListener() { 
public void onClick(View button) { 
((Button) button) .setText (stringFromJNI ()); 
} 
Ds; 


setContentView (button); 

} 

在 菜单 栏 中 , 选择 Source | Organize Imports 从 而 让 Eclipse 向 源 文 件 中 增加 必要 的 导入 
语句 。Eclipse 将 提供 多 种 可 供 选 择 的 OnClickListener 类 导入 选项 。 选择 android.view.View. 
OnClickListener 进行 处 理 。 修 改 的 onCreate 方法 将 一 个 按钮 放 在 展示 界面 ， 单 击 该 按钮 将 
开始 原生 调用 ， 这 将 确保 调试 会 话 正确 建立 之 后 启动 原生 调用 。 


5.2.4 ”启动 调试 器 
可 以 使 用 命令 行 方式 或 者 用 Eclipse 进行 原生 代码 的 调试 ， 本 节 将 讲解 这 两 种 方式 。 
1. 为 Windows 用 户 进行 修复 


Windows 平台 上 的 Android NDK 中 有 一 个 众所周知 的 bug， 它 阻止 GDB 对 二 进 制 文 
件 的 正确 定位 。ndk-gdb 脚本 用 GDB 脚本 文件 配置 GDB Client。 在 Windows 平台 上 ， 这 
个 脚本 文件 生成 时 带 有 额外 的 托 架 返回 ， 从 而 导致 这 个 问题 。 

为 了 修复 上 述 问 题 ,在 Eclipse 的 Editor 视 图 中 打开 <ANDROID NDK_ HOME>/mmdk-gdb 
脚本 。 将 光标 定位 在 文件 的 结尾 ， 追 加 程序 清单 5-15 所 示 的 修复 内 容 。 
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程序 清单 5-15 ”修复 GDB 设置 脚本 产生 器 
# 修复 行 尾 . 


sed -i 's/\r\r//' 'native path $GDBSETUP' 


SGDBCLIENT -x 'native path $GDBSETUP' 


2. 使 用 Eclipse 


像 运 行 应 用 程序 一 样 ， 为 了 建立 调试 会 话 ，Eclipse 需要 定义 调试 配置 。 
(1) 在 菜单 栏 中 选择 Run|Debug Configurations 打开 Debug Configurations 对 话 框 ， 如 
图 5-4 所 示 。 


Create. manage. and run cordigurations 
Androud Native Apphication 


fiter text 


日 问 Android Application 
-可 com example helloin Helloun 


| Cortigure launch settings from this dalog 

了 - Press the ‘New’ button to create a configuration of the selected type 

- Press the ‘Duphicate’ button to copy the selected corfiguration 

fd 六 P X - 
TY > press the Fiter buton to corfigure fitening options 
Tee 
回 C/C++ Mtach to Apphcation -Edit or view an existing corfiguration by selecting tt 
[© C/C++ Postmortem Debugger 


© C/C++ Remote Application Configure launch perspective settings from the ‘Perspectives' preference 
®@ Eclipse Application page 
加 | Java Applet 


Java Application 


Press the ‘Delete’ button to remove the selected configuration . 


图 5-4 新 建 Android 原生 应 用 配置 


(2) 在 左 侧 的 窗 格 中 ， 选 择 Android Native Application。 

(3) 在 会 话 工具 栏 单 击 new configuration 图 标 。 

(4) 如 图 5-5 所 示 ， 在 右 侧 的 窗 格 中 ， 单 击 Browse 按钮 选择 当前 项 目 。 
二 Debug Configurations 


Create. manage. and run conrfigurations 
Android Native Application 


x | 


Pype fitertexn 
日 铝 Android Application 
J Android JUnit Test 
日 可 Android Native Application 
New_corfiguration| © Launch Default Activity 
(© C/C++ Application 
© C/C++ Mtach to Application QU 
“C/C++ Postmortem Debugger © Do Nothing 
C/C++ Remote Application 
Ecip pp 


图 5-5 定义 原生 调试 配置 
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(5) 单 击 Apply 按钮 来 保存 调试 配置 。 

(6) 关闭 调试 配置 对 话 框 ， 回 到 Eclipse 工作 台 。 

现在 请 在 原生 代码 中 放置 一 个 断 点 来 终止 调试 进程 ， 为 此 需要 以 下 步骤 : 

(1) 如 前 所 述 ， 在 Editor 视图 中 打开 hellojni.c 源 文件 。 

(2) 进入 原生 函数 ， 右 击 Editor 视图 左 侧 的 标记 区 。 

(3) 如 图 5-6 所 示 , 在 上 下 文 菜单 中 选择 Toggle Breakpoint 选项 以 放置 一 个 断 点 , 此 时 
-个 蓝 色 的 圆 点 将 会 被 放置 在 标记 区 ， 表 示 它 是 一 个 断 点 。 


[© hello-jnic 2 [D) HelloJnijava 

® * Copyright (C) 2009 The Android Open Source Project] 
9 Hndlude <string h> 
3 hndlude <inih> 


$7 This is a trivial JNI example where we use a native method] 
jstring 
Java_com_example_helloini_HelloJni_stringFromJNI( JNIEnv” eny. 
1 jobject thiz ) 


To Prenv>NewShrinnNTERTY JNIIj 


gs resi pb +B 


Enable Broakpoint Shift*Double Click 


Breakpoint Properties... CuleDouble Click 
Breakpoint Types » 
图 5-6 切换 断 点 
小 贴 士 : 
用 相同 的 上 下 文 菜单 ， 我 们 也 可 以 放置 一 个 条 件 断 点 以 启用 或 禁用 已 经 存在 的 断 点 。 


(4) 既然 断 点 已 经 设置 成 功 ， 在 主 菜单 上 选择 Run | Debug Configurations 打开 Debug 
Configuration 对 话 框 。 

(5) 选择 之 前 定义 的 调试 配置 。 

(6) 单 击 Debug 按钮 。 

(7) 针对 不 同 的 任务 ，Eclipse 支持 不 同 的 视图 和 工作 台布 局 。 在 单 击 Debug 按钮 时 ， 
Eclipse 将 询问 用 户 是 否 切换 调试 视图 ， 如 图 5-7 所 示 。 单 击 Yes 继续 执行 。 


人 This kind of launch is configured to open the Debug perspective when it 
G | suspends. 


This Debug perspective is designed to support application debugoing 
momen en on ep ee oop Sp 


Do you want to open this perspective now? 


厂 Remember my decision 
Ci 


5-7 切换 到 调试 情景 


123 


Android C++ 高 级 编程 一 一 使 用 NDK 


(8) 用 Android 设备 或 模拟 器 ， 单 击 Call Native 按钮 来 调用 原生 函数 。 
原生 代码 一 旦 遇见 断 点 ， 应 用 程序 将 停止 并 将 控制 权 交 给 调试 器 ， 如 图 5-8 所 示 。 


ee 
日 回 Halouni Debug [Android Native Application] 


© /This is a trivial JNIeranple where we use a native method] 


Java_com_example_helloini_HelloJni_stringFromJNI( JNIEnv @iiy. 
jobject thiz ) 


rm camhahevammaurten "Helo fom ol 
| 
iLogGat 3 加 Gas | 四 Tads GProb © Fxec. Mem. = 
国 其 关 | 启 轴 攻 图 | | -3- 
HelloJni 


i TD ralloc goldfsh so 生生 sy 
工 08-09 23:11:4 33 


D 08-09 23:11:4 


图 5-8 正在 运行 的 Eclipse 调试 情景 


调试 情景 将 会 显示 一 个 原生 代码 当前 状态 的 完整 快照 。 在 左上 角 ，Debug 窗口 显示 正 
在 运行 的 线程 列表 以 及 当前 正在 运行 的 函数 。 在 右上 角 ，Variables 视图 让 你 访问 原生 变量 
并 查看 变量 的 当前 值 。 中 间 区 域 的 Editor 视图 中 显示 原生 源 代码 ， 在 下 一 步 将 要 被 执行 的 
那 行 代码 左 侧 的 标记 条 上 有 一 个 箭头 。 可 以 用 如 图 5-9 所 示 的 调试 工具 栏 来 控制 应 用 程序 
的 执行 。 


5-9 调试 工具 条 


下 面 的 操作 是 通过 调试 工具 栏 完 成 的 : 
e Skip All Breakpoints: 使 所 有 的 断 点 无 效 。 
。 Resume: 重新 开始 执行 原生 代码 直到 下 一 个 断 点 。 
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e Suspend: 通过 向 进程 发 送 SIGINT 中 断 信号 来 挂 起 正在 执行 的 原生 代码 ， 此 时 可 
以 检查 原生 代码 的 当前 状态 。 
Step Into: 通过 进入 来 执行 下 一 个 原生 调用 。 
Step Over: 执行 下 一 个 原生 调用 ， 然 后 停止 。 
Step Return: 执行 直至 原生 函数 返回 。 
Terminate: 结束 这 个 调试 会 话 。 
不 仅 可 以 用 Eclipse 调试 原生 应 用 程序 ， 也 可 以 用 命令 行 方式 实现 相同 级 别 的 调试 
功能 。 


3. 命 令 行 


在 命令 行 方式 下 ， 可 以 用 ndk-gdb 脚本 调试 原生 代码 ， 当 前 的 ndk-gdb 脚本 要 求 运行 
UNIX shell。 在 Windows 平台 上 ， 可 以 用 Cygwin 代替 命令 提示 符 来 调试 。 首 先 ， 打 开 基 
于 所 使 用 平台 的 Cygwin 或 终端 窗口 。 可 以 使 用 hello-jni 示例 项 目 做 这 个 实验 。 

(D 为 了 防止 发 生 冲 突 ， 确 保 Eclipse 没有 再 运行 。 

(2) 将 hello-jni 项 目 目录 设置 成 当前 工作 目录 。 

(3) 调用 rm-rf bin obj libs 命令 删除 Eclipse 中 的 所 有 残留 文件 。 

(4) 在 命令 行 方式 下 调用 ndk-build 命令 编译 原生 模块 。 

(5) 为 了 在 命令 行 方式 下 编辑 和 打包 应 用 程序 ， 确 保 ANT 版 本 的 构建 脚本 文件 build.xml 
存在 于 项 目 目录 中 。 如 果 这 是 你 第 一 次 在 命令 行 方式 构建 该 项 目 ， 调 用 android update 
project -p 命令 生成 必要 的 构建 文件 。 如 果 使 用 Cygwin, 那么 请 用 android.bat 代替 android 。 

(6) 在 命令 行 方式 下 调用 ant debug 命令 在 调试 模式 下 编译 和 打包 项 目 。 

(7) 在 命令 行 方式 下 调用 ant installd 命令 将 应 用 程序 部 署 到 设备 或 模拟 器 上 。 

(8) 默认 情况 下 , ndk-gdb 脚本 搜寻 一 个 已 经 运行 的 应 用 程序 进程 ; 然而 , 可 以 用 --start 
或 者 --launch=<activity> 参 数 在 调试 会 话 前 自动 启动 应 用 程序 。 在 命令 行 方式 下 调用 ndk-gdb 
--start 命令 启动 调试 会 话 。 当 GDB 成 功 依附 于 hello-jni 应 用 程序 时 ， 显 示 GDB 提示 符 。 

(9) 在 GDB 提示 符 下 ， 调 用 b hello-jni.c:30 命令 在 hello-jni.c 源 文件 的 第 30 行 增加 一 
个 断 点 。 

(10) 既然 断 点 已 经 定义 ， 在 GDB 提示 符 下 调用 ¢ 继续 执行 原生 应 用 程序 。 

(11) 在 Android 设备 或 模拟 器 中 ， 单 击 Native Call 按钮 来 调用 原生 函数 。 


注意 : 
看 见 一 长 串 显示 GDB 不 能 定位 多 种 系统 库 文 件 的 错误 消息 是 很 正常 的 , 你 可 以 忽略 
那些 消息 ， 因 为 这 些 库 文件 的 symbol/debug 版 本 不 可 用 。 


当 原生 函数 遇见 断 点 时 ， 应 用 程序 将 停止 ， 此 时 可 以 用 GDB 检查 原生 代码 的 当前 状 
态 ， 如 图 5-10 所 示 。 
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Ee el E| 
min Unable to find dynamic linker breakpoint function. -| 
GDB will be unable to debug shared ay initializers 

and track explicitly loaded dynamic code. 

warning: shared bay handler failed to enable breakpoint 

(gdb) b hello-jni.c: 

Breakpoint 1 at X74doc38: file jni/hello-jni.c, line 30. 

(gdb) c 

Continuing. 

[New Thread 787] 

LSwitching to Thread 787] 


Breakpoint 1, Java_com_example_hellojni_HelloJni_stringFromJNI (env=0xf2c0, 
thiz=0x413476b8) at jni/hello-jni.c:30 
return (*env)->NewStringUTF(env, "Hello from JNI !1"); 
ab) | 加 


图 5-10 命令 行 调试 会 话 
4. 有 用 的 GDB 命令 


下 面 是 可 以 在 GDB 提示 下 使 用 的 、 用 来 调试 原生 代码 的 有 用 GDB 命令 : 
。 break<where>: 在 指定 的 位 置 放置 断 点 。 位 置 可 以 是 一 个 函数 名 、 文 件 名 或 行 数 ， 
如 file.c:10。 

enable/disable/delete<#>: 激活 、 禁 用 或 删除 指定 编号 的 断 点 。 
clear: 清除 所 有 断 点 。 

next: 跳 到 下 一 个 指令 。 

continue: 继续 执行 原生 代码 。 

backtrace: 显示 所 有 的 堆栈 。 

backtrace full， 显 示 在 每 一 个 框架 中 包含 局 部 变量 的 调用 堆栈 。 
print<what>: 打印 变量 、 表 达 式 、 内 存 地址 或 寄存 器 的 内 容 。 
display<what>: 和 print 相同 ， 但 在 每 一 个 指令 步 之 后 输出 值 。 
what is <variable>: 显示 变量 的 类 型 。 

info threads: 列 出 所 有 运行 中 的 线程 。 

thread <thread>: 在 选择 的 线程 上 操作 。 

help: 返回 所 有 命令 列表 的 帮助 信息 。 

quit: 结束 调试 会 话 。 


注释 : 
当 退 出 GDB 提示 符 状态 时 ， 调 试 的 应 用 程序 将 停止 ， 这 是 一 个 众所周知 的 限制 。 


想 了 解 更 多 关于 GDB 的 信息 请 访问 www.gnu.org/software/gdb/documentation/ 查 看 GDB 
文档 。 


5.3 ”故障 处 理 


在 开发 阶段 ， 日 志 让 你 确定 和 展示 应 用 程序 的 状态 信息 ， 这 些 信 息 将 对 之 后 解决 问题 
有 帮助 。 当 通过 日 志 记录 的 信息 不 够 时 但 知道 问题 可 能 处 在 哪个 环节 时 ， 调 试 就 会 发 挥 作 
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用 。 当 你 遇 到 意料 之 外 的 问题 时 ， 故 障 诊断 技术 将 变 成 一 个 救星 。 了 解 正确 的 工具 和 技术 
将 使 你 能 够 快速 解决 问题 ， 本 节 简 要 介绍 这 部 分 内 容 。 


5.3.1 堆栈 跟踪 分 析 


为 了 进行 堆栈 跟踪 分 析 ， 需 要 在 hello-jni 示例 应 用 程序 中 植 入 一 个 会 引起 故障 的 bug。 
用 Eclipse 打开 hello-jni.c 源 文件 ， 按 照 程 序 清单 5-16 所 示 修 改 原生 函数 的 内 容 。 


程序 清单 5-16 将 Bug 引入 到 原生 函数 


static jstring funcl( JNIEnv* env ) 


{ 

/* BUG 开始 */ 

env= 0; 

/* BUG 结束 */ 

return (*enV) ->NewStringUTE (env, "Hello from JNI !") 7 
} 
jstring 


Java_com example hellojni HelloJni stringFromJNI( JNIEnv* env, 
jobject thiz ) 
{ 


return funcl (env); 


} 


通过 将 JNIEnv 接口 指针 的 值 设置 为 0， 我们 将 触发 这 个 故障 。 现 在 构建 并 运行 该 应 用 
程序 。 当 应 用 程序 启动 时 ， 单 击 Call Native 方法 来 调用 原生 函数 。 应 用 程序 将 中 断 ，logcat 
中 将 显示 堆栈 跟踪 ， 如 图 5-11 所 示 。 


/cygdrive/c/android/workspace/com example helloini HelloJni 
: Fatal signal 11 (SIGSEGV) at 0x00000000 (code=1) 


从 安安 安安 安 安安 安安 容 安 安安 安 从 安安 安安 安安 安安 安安 安 安安 安 安安 宙 ” 安 安安 安安 安安 安安 安安 


: Build fingerprint: ‘generic/sdk/generic:4.0.2/ICS_MRO/229537:eng/test-ke 


: pid: 526, tid: 526 >>> com.example.hellojni <<< 
: signal 11 (SIGSEGV), code 1 (SEGV_MAPERR), fault addr 00000000 
: rO 0000f2c0 rl1 4134del0 r2 42a7cde4 r3 00000000 
r4 42d00008 r5 42a7cdac r6 00000004 r7 42a7cdb8 
r8 be91b638 r9 42a7cdb0 10 00012820 fp be91b64c 
ip 473ccc5d sp be91b618 lr 473ccc6d pc 473ccc3c cpsr 40000030 
d0 0000000080000000 di 0000000080000000 
0000000000000000 3ea9c6403f54e320 
43952a7200000000 3f2aaaabc38c0039 
000000003f2aaaab 0000000000000000 


0000000000000000 
0000000000000000 
0000000000000000 
0000000000000000 


60000012 


#00 peCCoooc) /data/data/com. example. hellojni/1ib/1ibhe11o- 


34) : pc 00000c68 /data/data/com.example.hellojni/1ib/1ibhello- 
jni.so Cava cam exarple_heyfodni hed orn stringFromJNI) 
34. #02 pc O00lec70 /system/1ib/1ibdvm.so rs 
#03 pc 0005925a /system/1ib/1ibdvm.so (_Z16dvmCallJNIMethodpK 


I/DEBUG  ( 34): #04 pc 0004cc7c /system/1ib/1ibdvm. so (_z2ldvncheckCal1]NINet 吕 | 
hodpKjP6JValuePK6Methodp6Thread) ml 


5-11 Logcat 显示 故障 后 的 堆栈 跟踪 
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这 些 以 井 号 ( 才 开 头 的 行 表示 调用 堆栈 。 第 一 行 以 #00 开头 ， 是 故障 发 生 的 地 方 ， 下 一 
行 #01 是 以 前 的 函数 调用 ， 以 此 类 推 。pe 后 面 跟 的 数字 是 代码 的 地 址 。 如 在 堆栈 跟踪 中 看 
到 的 ， 原 生 代码 在 地 址 为 00000c3c 处 发 生 故 障 ， 前 一 个 函数 调用 是 stringFromJNI 原生 函 
数 。 地 址 00000c3c 本 身 不 能 说 明太 多 问题 ， 但 如 果 借 助 正确 的 工具 ， 这 个 地 址 将 被 用 来 找 
到 故障 发 生 的 确切 文件 和 行 号 。Android NDK 带 有 一 个 叫做 ndk-stack 的 工具 , 它 能 够 把 堆 
栈 跟踪 转换 成 确切 的 文件 名 和 行 号 。 在 命令 行 方式 下 进入 到 项 目 根 目录 ， 执 行 以 下 命令 : 


adb logcat | ndk-stack =sym obj/local/armeabi 


ndk-stack 工具 将 翻译 堆栈 跟踪 ,如 图 5-12 所 示 。 地 址 显示 到 了 jni/hello-jni.c 源 文件 的 
33 行 。 有 了 这 种 信息 ， 故 障 诊断 容易 多 了 。 通 过 简单 地 在 该 地 址 放 一 个 断 点 ， 可 以 停止 应 
用 程序 并 检查 应 用 程序 的 状态 。 


~ /cygdrive/c/android/workspace/com example hellojni HelloJni | - 口 | x| 


$ adb logcat | ndk-stack -sym ob]j/1ocalV/armeab1i 
Crash dUMp: “eee 
Build fingerprint: ‘generic/sdk/generic:4.0.2/ICS_MRO/229537:eng/test-keys" 
pid: 526, tid: 526 >>> com.example.hellojni <<< 
一 一 GY MAPERR), fault addr 00000000 
rame #00 pc “00000c3c /data7gz com. examp1le.hel11ojni/1ib/1ibhe11o-jni.s 
Routine funcl in jni/hello-jni 


a SA/com.example.hel11ojni/1ib/1ibhe11o-jni.s 

0 (Java_cd p DJni_stringFrom]NI) : Routine Java_com_examp] en 
ellojni, Hel Toni _stri ngFromJNI in jni/hello-jni.c:40 

Stack frame #02 pc O00lec70 /system/1ib/1ibdvm.so (dvmPlatformInvoke) 

Stack frame #03 pc 0005925a /System/1ib/1ibdvm.so (_Z16dvmCallJjNIMethodPKjP6I]V 
aluePK6MethodP6Thread) 

Stack frame #04 pc 0004cc7c /system/1ib/1ibdvm.so (_Z21dvmCheckCa11]JNIMethodPK 
JP6]JValuePK6MethodP6Thread) 

Stack frame #05 pc 0005af84 /system/1ib/1ibdvm.so (2Z22dvmResolveNativeMethodP 
KJjP6]ValuePK6MethodP6Thread) 

Stack frame #06 pc 00030a8c /system/1ib/1ibdvm.so 

Stack frame #07 pc 000342ac /system/1ib/1ibdvm.so (Z12dvmInterpretP6ThreadPK6 
MethodP6]JValue) 

Stack frame #08 pc O006c93e /system/1ib/1ibdvm.so (_Z15dvmInvokeMethodP60bject 
PK6MethodPllArrayObjectS5_Pl1CiassObjectb) 

Stack frame #09 pc 00073d4a /system/1ib/1ibdvm.so 

Stack frame #10 pc 00030a8c /system/1ib/1ibdvm.so -| 


图 5-12 Ndk-stack 翻译 代码 地 址 


5.3.2 ”对 JNI 的 扩展 检查 


默认 情况 下 ，JNI 函数 基本 不 做 错误 检查 。 错 误 通 常会 导致 故障 。Android 为 JNI 调用 
提供 了 一 个 拓展 的 检查 方式 ， 被 称 之 为 CheckJNI。 当 激活 该 功能 时 ，JavaVM 和 JNIEnv 
接口 指针 切换 到 函数 表 ， 这 些 函数 表 在 调用 实际 的 实现 之 前 执行 扩展 错误 检查 。CheckJNI 
能 检测 出 以 下 问题 : 

e 企图 分 配 负 数 大 小 的 数组 ; 
将 错误 的 指针 或 Null 指针 传递 给 JNI 函数 ; 
传递 类 名 称 时 语法 错误 ; 
在 临界 区 调用 JNI; 
给 NewDirectByeBuffer 传递 错误 参数 ; 
当 一 个 异常 挂 起 时 调用 JNI:; 
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用 在 错误 的 线程 中 的 JNIEnv 接口 指针 ; 
域 类 型 与 Set<Type>Field 函数 不 匹配 ; 
方法 类 型 与 Call<Type>Method 函数 不 匹配 ; 
用 错误 的 引用 类 型 调用 DeleteGlobalRef/DeleteLocalRef; 
错误 的 释放 模式 传递 给 Release<Type>ArrayElement 函数 ; 
从 原生 方法 返回 不 兼容 类 型 ; 
无 效 的 UTF-8 数列 传递 给 JNI 调用 ; 
默认 情况 下 , CheckJNI 模式 只 能 在 模拟 器 中 使 用 , 不 能 在 常规 的 Android 设备 中 使 用 ， 
因为 它 会 影响 整个 系统 的 性 能 。 


启用 CheckJNI 
在 常规 设备 上 ， 在 命令 行 方式 下 执行 以 下 命令 可 以 启用 CheckJNI 模式 : 
adb shell setprop debug.checkjni 1 


这 不 会 影响 运行 中 的 应 用 程序 ， 但 是 任何 后 来 打开 的 应 用 程序 都 将 启用 CheckJNI。 
CheckJNI 状态 也 显示 在 logcat 中 ， 如 图 5-13 所 示 。 


D/AndroidRuntime( 679): >>>>>>_And 
timeInit <<<<<< 


D/AndroidRuntime( 679 ~ 


I/ActivityManager( 77) S ES eandroid。 intent. action。 MAIN cat=[android. int 
rt Category.LAUNCHER] 0 0000 cmp=Com. example.hellojni/.Hellojni} from p 


Nd onansgerC 77): Failure taking screenshot for (180x300) to layer 21005 
D/AndroidRuntime( 679): Shutting down VM 


5-13 在 logcat 中 显示 CheckJNI 的 状态 


为 了 实现 CheckJNI， 用 Eclipse 打开 hello-jni.c 源 代码 。 如 程序 清单 5-17 所 示 修 改 原 
生 函 数 。 


程序 清单 5-17 ”根据 原生 大 小 创建 数组 


jstring 
Java_com example hellojni HelloJni stringFromJNI( JNIEnv* env, 
jobject thiz ) 
jintArray javaArray = (*env)->NewIntArray (env, -1); 


return (*env)->NewStringUTF (env, "Hello from JNI !1"); 
} 


你 将 用 一 个 负数 作为 数组 大 小 来 创建 一 个 新 的 实数 数组 。 在 模拟 器 上 构建 并 运行 应 用 
程序 。 当 应 用 程序 启动 时 ， 单 击 Call Native 按钮 调用 原生 函数 。 如 图 5-14 所 示 ，CheckJNI 
将 在 logcat 中 显示 警告 消息 并 且 终 止 执行 。 
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egative jsize (NewIntArray) 


I/dalvikvmC ; group="main” sCount=0 dsCount=0 obj=0x40997460 self=0x128 
10 


I/dalvikvm( 3 | sysTid=742 nice=0 sched=0/0 cgrp=default handle=107408295 
2 


I/dalvikvm( 3 | schedstat=( 293633435 735862963 95 ) utm=14 stm=15 core=01 
I/dalvikvm( 8 at com.example.he11ojni.Hel1oJni.stringFrom]INI(Native Metho 


I/dalvikvm( 日 at com. example. hellojni. HelloJni$1.onClick(HelloJni. java:43|7| 


图 5-14 关于 数组 大 小 为 负数 的 JNI 警告 
5.3.3 ”内 存 问题 


在 没有 正确 的 工具 时 很 难 诊断 出 内 存 问 题 ， 本 节 将 简要 介绍 两 种 诊断 内 存 问 题 的 
方法 。 


1. 使 用 libc 调试 模式 


如 果 使 用 模拟 器 , 启用 libe 调试 模式 就 能 够 诊断 出 内 存 问 题 。 为 了 启用 libe 调试 模式 ， 
使 用 程序 清单 5-18 所 示 的 命令 。 


程序 清单 5-18 ”打开 libc 调试 模式 


adb shell setprop libc.debug.malloc 1 
adb shell stop 
adb shell start 


支持 libe 调试 模式 的 值 是 : 

e 1: 执行 泄露 探测 。 

e 5: 填补 分 配 的 内 存 检查 超支 。 

e 10: 填补 内 存 和 定点 检查 超支 。 

为 了 使 用 Libe 调试 模式 ， 用 Eclipse 打开 hello-jni.c 源 代码 。 如 程序 清单 5-19 所 示 修 
改 原生 函数 。 


程序 清单 5-19 ”修改 超出 分 配 的 缓存 的 内 存 


jstring 
Java_com example hellojni HelloJni stringFromJNI( JNIEnv* env, 
jobject thiz ) 
{ 
char* buffer; 
B42e 村 到 


buffer (char*) malloc(1024) 7 
for (i = 0; i < 1025; i++) 
{ 


buffer[i] = 'a'; 
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free (buffer); 


return (*env)->NewstringUTF (env, "Hello from JNI !"); 


} 
你 将 分 配 到 1 024 字 节 ， 但 是 代码 将 修改 所 分 配 内 存 之 外 的 额外 内 存 ， 这 会 导致 内 存 
崩溃 。 执 行程 序 清单 5-20 所 示 的 命令 打开 libe 调试 模式 。 
程序 清单 5-20 ”为 内 存 崩溃 检测 开启 libc 调试 模式 


adb shell setprop libc.debug.malloc 10 
adb shell stop 
adb shell start 


在 模拟 器 上 构建 并 运行 应 用 程序 。 当 应 用 程序 启动 的 时 候 ， 单 击 Call Native 按钮 调用 
原生 函数 。 如 图 5-15 所 示 ，libc 调试 模式 将 在 logcat 中 显示 一 个 关于 内 存 崩 溃 的 警告 消息 
并 终止 执行 。 

: app_process Using MALLOC_DEBUG = 10 (sentinels, f111) 


: ***# FREE CHECK: buffer Oxa5218, size=1024, corrupted 1 bytes 


: Call stack: 
: 0: 40069f1ic 
: 40069fe4 


: 4006a010 
: 4001a0be 


图 5-15 Libc 调试 模式 下 显示 内 存 崩溃 错误 


2. Valgrind 


Libe 调试 模式 可 以 对 内 存 问 题 做 基本 的 故障 诊断 ，Valgrind 可 以 用 来 进行 更 高 级 的 内 
存 分 析 。 它 是 一 个 用 于 内 存 调试 、 内 存 泄漏 检测 和 概要 分 析 的 开源 工具 。 要 完成 这 个 实验 ， 
可 以 在 本 书 提供 的 网 址 下 载 prebuilt Valgrind 二 进 制 文件 或 在 你 自己 的 机 器 上 构建 。 如果 你 
想 构 建 ， 跳 到 “从 源 代码 构建 ”一 节 。 

(1) 使 用 Prebuilt 二 进 制 文件 

用 你 的 web 浏览 器 , 从 http://zdo.com/valgrind-arm-emulator-3.8.0.zip 下 载 ARM 模拟 器 
下 的 Valgrind 二 进 制 文件 压缩 文件 。 解 压缩 ZIP 文件 的 内 容 并 把 它 的 位 置 记录 下 来 ， 跳 到 
“安装 到 模拟 器 ”一 节 。 

(2) 从 源 代码 构建 

为 了 从 源 代码 中 为 Android 系统 建立 合适 的 Valgrind， 需 要 一 个 Linux 宿主 系统 。 
Valgrind 的 官方 发 行 版 本 支持 Android。 从 http://valgrind.org/downloads/current.html 下 载 最 
新 版 本 的 Valgrind。 在 本 书 编写 时 ，Valgrind 的 最 新 版 本 是 3.8.0， 它 是 一 个 BZIP2 压缩 的 
TAR 文件 。 在 命令 行 方式 下 ， 执 行 以 下 命令 解压 缩 。 
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tar jxvf valgrind-3.8.0.tar.bz2 


在 解压 缩 Valgrind 源 文件 时 ， 使 用 你 的 编辑 器 打开 README.android 文件 查看 最 新 的 
构建 指令 。 因 为 在 Android 模拟 器 中 使 用 Valgrind， 请 确认 通过 执行 下 列 命令 将 HWKIND 
的 值 设 置 成 emulator。 


export HWKIND=emulator 


在 建立 合适 的 Valgrind 时 ， 二 进 制 文件 和 其 他 必 备 组 件 将 被 放置 在 Inst 子 目 录 中 。 

(3) 将 Valgrind 部 署 到 模拟 器 

在 使 用 Valgrind 之 前 需要 将 其 部 署 到 模拟 器 中 。 为 了 完成 此 项 任务 ， 打 开 Cygwin 或 

-个 终端 窗口 。 如 果 你 使 用 的 是 预 构建 二 进 制 文件 ， 请 进入 解压 缩 文件 的 根 目录 ; 如 果 从 

源 代码 构建 ， 进 入 Valgrind 源 代码 根 目 录 ， 在 命令 行 方 式 下 执行 下 列 命 令 : 

adb push Inst / 

这 将 把 Valgrind 文件 部 署 到 模拟 器 上 的 /data/local/Inst 目录 下 。 在 将 文件 部 署 到 设备 上 
时 ， 需 要 修改 执行 位 。 为 此 执行 以 下 命令 : 


adb shell chmod 755 \ 
$ (find Inst -type f -exec file {} \; | \ 
grep executable | \ 
sed -nn -~e "a/^Inst\V (I*s]*M.*$/NL/gp” TAN 
xargs) 
(4) Valgrind 包装 器 
除了 Valgrind 二 进 制 文 件 ， 还 需要 一 个 帮助 脚本 。 使 用 Eclipse 或 者 你 喜欢 的 编辑 器 ， 
用 程序 清单 5-21 显示 的 内 容 创 建 名 为 valgrind_wrappersh 的 新 文件 。 
程序 清单 5-21 Valgrind 包装 器 Shell 脚本 
#!/system/bin/sh 


export TMPDIR=/sdcard 


exec /data/local/Inst/bin/valgrind --error-limit=no $* 


修改 包装 器 脚本 的 最 后 一 行 时 ,把 它 部 署 到 模拟 器 上 ， 并 执行 程序 清单 5-22 所 示 的 命 
令 授予 命令 的 可 执行 权限 。 
程序 清单 5-22 部 署 Valgrind 包装 器 脚本 


dos2unix.exe valgrind wrapper.sh 

adb push valgrind wrapper.sh /data/local/Inst/bin 

adb shell chmod 755 /data/local/Inst/bin/valgrind wrapper.sh 

(5) 运行 Valgrind 

为 了 在 Valgrind 下 运行 应 用 程序 , 执行 程序 清单 5-23 所 示 的 命令 在 启动 序列 中 引入 包 
装 器 脚本 。 
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程序 清单 5-23 ”在 启动 序列 中 引入 Valgrind 包装 器 


adb shell setprop wrap.com.example.hellojni \ 
"logwrapper /data/local/Inst/bin/valgrind wrapper.sh" 


该 属性 键 的 格式 是 wrap.<package name>。 为 了 在 Valgrind 下 运行 其 他 应 用 程序 ， 只 要 
用 合适 的 值 替 代 包 名 即 可 。 停 止 然后 重启 应 用 程序 ，Valgrind 消息 将 被 展示 在 Logcat 上 ， 
如 图 5-16 所 示 。 


daivkvnC 674); Evec: 


/Systen/din/sh -< )0gor pper /Gatal local/Inst/dn/valor nd_wr apper. sh /systen/ bn/ apo-process -有 
~"apolication 


riCernase=com exasple. hellojn” com.android. internal.os.wrapperInit 29 3 “android, app. Acti 


Yat TcaY /Ins /vin/valorind_ wrapper. 人 


y err 
1(/eata/Tocad/Inss/bin/valor namr apper. EY 


-657 Copyright 5 3 $02” 3 SS Pt’d, by Julian Seward et 
68Tem Using Vaigrind-3.8.0 and LibVEX; rerun with -h for copyright 
Y//éata/1ocal/Inst/bin/ velgr ind- wr aoper, sh¢ ,6): TeéS re Command: {sr3ten/bin/ ep process /systes Din 

-pice-mamewcom exarple, hellojn, com, andrond, internal, os.wrapoerInit 29 3 androtd,app.ActivityThread 
1//data/ 1ocal/inst/bin)valorind_ nr apper. Sh( 656): ~-687= 

E/Activitymanager( 90): *O% 687/val 


T//gata/Vocal/Inst/bin/valorind_mrapper. sh 636): 
nfo 


--application - 


O% vser » ON kernel 


/Act i tMansdert 30); "Hew 人)vagorynd: er / font S64 winer 
I//data/Vocal/Inst/bin/valor ind_wr apper. sh' : "687 Thread $: 
1//data/local/inst/bin, 


Conditicnal jurp cr nove depends on uninitialised value(s) 
at O4820004: 一 vfprintf (in 15y3tem/iib/1ibc.3o) 


Conditional jump or wove depends on uninitialised value(s) 
3 本 
HA tA Aes 3 


1//data/ Vocal/Inst/bin/valor ind_nr apper .5ht : e687 Conditional jump or wove depends on uninitialised value(s) 


图 5-16 Logcat 显示 Valgrind 消息 


在 Valgrind 下 运行 应 用 程序 将 大 幅度 地 降低 应 用 程序 的 运行 速度 。Android 系统 可 能 
会 抱怨 进程 没有 响应 。 在 这 种 情况 下 ， 请 单 击 Wait 按钮 给 Valgrind 更 多 的 时 间 。 


5.3.4 strace 


在 某 些 情况 下 ， 你 可 能 想 在 没 和 调试 器 相连 也 不 增加 大 量 日 志 消息 的 情况 下 监控 应 用 
程序 的 每 个 活动 。 用 strace 工具 可 以 很 容易 的 实现 该 功能 。strace 工具 是 有 用 的 诊断 工具 ， 
因为 它 拦截 并 记录 应 用 程序 调用 的 系统 调用 以 及 收 到 的 信号 。 每 一 个 系统 调用 的 名 字 、 参 
数 及 返回 值 都 会 被 输出 。 注 意 Android 模拟 器 带 有 strace 功能 。 


为 了 使 用 strace， 用 Eclipse 打开 hello-jni.c 源 代码 。 按 照 程序 清单 5-24 的 内 容 修改 源 
文件 。 

程序 清单 5-24 ”增加 了 两 个 系统 调用 的 原生 源 代码 

#include <unistd.h> 

eid 

Java com example hellojni HelloJni stringFromJNI( JNIEnVv* enV， 
jobject thiz) 


{ 

getpid(); 

getuid(); 

return (*env)->NewStringUTF (env, "Hello from JNI !1"); 
} 
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在 模拟 器 上 构建 并 运行 应 用 程序 。 打 开 Cygwin 或 一 个 终端 窗口 ， 当 应 用 程序 启动 时 ， 
执行 下 列 命 令 以 获得 应 用 程序 的 进程 D: 


adb shell ps | grep com.example.hellojni 


第 三 列 的 数字 是 进程 ID， 如 图 5-17 所 示 。 


$ adb sh | grep com.example.hellojni 
app_40 3998 3366 126652 35060 FFFPHPFF 40011384 5 com.example.hellojni 
5 | 


5 
] 


图 5-17 获得 应 用 程序 的 进程 DD 
执行 以 下 命令 ， 通 过 替代 进程 ID 使 strace 联系 到 运行 中 的 应 用 程序 进程 
adb shell strace -V -p <Process ID> 


如 你 所 见 ，strace 将 被 链接 到 应 用 程序 的 进程 ， 并 且 它 将 拦截 并 显示 系统 调用 、 参 数 
及 其 返回 值 。 单 击 Call Native 按钮 调用 原生 函数 ，strace 将 显示 两 个 引入 到 原生 代码 中 的 
系统 调用 ， 如 图 5-18 所 示 。 


$ adb shell strace -v -p 3998 
Process 3998 attached - interrupt to quit 


msgget (Ox1, Oxbefae640, Oxbefae640, Ox40103ee0) = 0 
semget (Ox22, Oxbefae4e0, Ox10, Oxf FFFFFFF) =1 
read(46, "D*, 1) =1 
ioct1(45, Ox40087707, Oxbefae430) =0 
writeC33, WA =1 

msgget (Ox1, Oxbefae640, Oxbefae640, Ox40103ee0) = 0 
msgget (Ox1, Oxbefae640, Oxbefae640, Ox40103ee0) = 0 
msgget (Ox1, Oxbefae640, Oxbefae640, 人 = 0 
write(47, Lp™ ， 1) = 

getpidO = joss 
getuid320) = 10040 
semget (Ox22, Oxbefae4e0, Ox10, 0) =2 
read(28, “Ww ，16) =1 
read(46, "D”, 1) =1 


图 5-18 strace 显示 系统 调用 
无 论 是 打开 还 是 关闭 代码 应 用 程序 ，strace 都 是 有 效 的 故障 诊断 工具 。 


5.4 小 结 


本 章 学 习 了 Android 平台 上 的 日 志 、 调 试 和 故障 诊断 的 工具 和 技术 。 在 以 后 的 章节 中 
你 会 发 现 ， 用 Android 平台 提供 的 原生 APIs 进行 实验 时 ， 本 章 给 出 的 概念 会 非常 有 用 。 
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Bionic API 入 门 


第 5 章 学 习 了 有 关 Android 原生 应 用 程序 开发 的 日 志 、 调试 以 及 故障 排除 工具 和 技术 。 
从 本 章 开 始 ， 我 们 将 深入 探讨 Android NDK 提供 的 原生 API。 

Bionic 是 Android 平台 为 使 用 C 和 C++ 进行 原生 应 用 程序 开发 所 提供 的 POSIX 标准 C 
库 。 它 是 Google 为 Android 操作 系统 提供 的 BSD 标准 C 库 的 衍生 库 。 它 由 带 有 可 处 理 线 
程 、 进 程 和 信号 的 定制 Linux 专用 位 的 混合 BSD C 库 文 件 片 组 成 ,“Bionic” 的 名 称 就 是 来 
源 于 此 。 

Bionic 是 原生 应 用 程序 开发 的 重要 内 容 ， 因 为 它 提供 了 在 Android 平台 上 开发 任何 类 
型 的 功能 性 原生 代码 所 需要 的 最 小 构造 集 。 在 以 后 的 章节 中 ， 我 们 将 在 很 大 程度 上 依赖 于 
Bionic 所 提供 的 功能 。 在 了 解 Bionic 的 具体 内 容 之 前 , 我 们 先 快速 回顾 一 下 一 般 的 标准 库 。 


6.1 回顾 标准 库 


编程 语言 的 标准 库 提供 了 经 常 要 用 到 的 构造 、 算 法 、 数 据 结构 以 及 任务 的 抽象 接口 ， 
这 些 任务 通常 主要 涉及 硬件 和 操作 系统 ,例如 网 络 访问 、 多 线程 、 内 存 管 理 和 文件 1/O 等 。 
由 于 不 同 编程 语言 的 特性 差异 很 大 ， 因 此 它们 的 标准 库 千差万别 ， 可 以 是 非常 小 的 一 组 只 
适用 于 重要 任务 的 构造 ， 也 可 以 非常 广泛 、 功 能 强大 。 无 论 如 何 ， 为 了 给 应 用 程序 开发 提 
供 方便 ， 每 种 编程 语言 的 实现 都 提供 标准 库 。 

几乎 每 一 种 编程 语言 都 有 一 个 标准 库 。Java 平台 的 标准 库 是 Java Class Library(JCL)， 
它 是 一 个 Java 编程 语言 的 标准 库 ， 包含 了 一 组 适用 于 排序 、 字 符 串 操作 等 常见 操作 的 全 面 
的 标准 类 库 和 一 个 访问 底层 操作 系统 服务 的 抽象 接口 , 例如 可 用 于 文件 与 网 络 交 互 的 VO 
流 。Android 框架 通过 结合 Android 应 用 程序 开发 特有 的 附加 构造 扩展 了 JCL。 

对 C 语言 来 说 ，ANSI C 标准 定义 了 标准 库 的 范围 。 该 标准 库 被 称 为 C 标准 库 ， 或 简 
称 为 libc。C 语言 的 实现 也 伴随 着 C 标准 库 的 实现 。 除 了 标准 C 库 的 规范 ，POSIX C 库 的 
规范 声明 了 附加 结构 ， 在 POSIX 兼容 系统 中 ， 这 些 附加 结构 应 该 包含 在 此 类 标准 库 里 。 
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6.2 还 有 另 一 个 C 库 


Google 创建 一 个 新 的 C 库 而 不 复 用 现 有 的 GNU C 库 (glibc) 或 Embedded Linux C 库 
(uClibe) 的 动机 可 总 结 为 以 下 三 点 : 

e 许可 : glibc 和 uClibc 在 GNU Lesser General Public License (LGPL，GNU 宽 通 用 公 
共 许 可 ) 下 均 可 用 ， 从 而 限制 了 可 被 专用 应 用 程序 使 用 的 方式 。 相 反 ，Bionic 是 在 
BSD 许可 下 发 布 的 ， 该 许可 非常 自由 ， 不 对 库 的 使 用 做 任何 限制 。 

e 速度 : Bionic 是 专门 为 移动 计算 精心 设计 的 。 针 对 移动 设备 上 有 限 的 CPU 周期 和 
可 用 内 存 进 行 了 裁剪 以 提高 工作 效率 。 

e 大 小 : Bionic 的 核心 理念 是 简单 化 。 它 提供 了 针对 内 核 功能 的 轻 量 级 包装 器 和 一 组 
较 小 的 API， 使 得 它 比 其 他 的 代替 品 小 。 本 章 将 会 介绍 这 些 API。 


6.2.1 二 进 制 兼容 性 


尽管 Bionic 是 C 标准 库 ， 但 它 不 以 任何 方式 与 其 他 C 库 二 进 制 兼容 。 用 其 他 C 库 生 
成 的 目标 文件 和 静态 库 不 应 该 与 Bionic 进行 动态 链接 ， 这 么 做 通常 会 导致 无 法 链接 或 无 法 
正确 执行 你 的 原生 应 用 程序 。 

除 此 之 外 , 任何 与 其 他 C 库 静 态 链 接生 成 的 、 且 不 与 Bionic 混合 的 应 用 程序 都 无 可 争 
议 地 可 以 在 Android 平台 上 运行 ， 除 非 它 在 运行 时 动态 加 载 了 其 他 系统 库 。 


6.2.2 提供 了 什么 


Bionic 提供 C 标准 库 宏 、 类 型 定义 、 函 数 和 少数 Android 特有 的 特性 ， 这 些 特 性 可 分 
项 在 以 下 功能 域 中 列 出 : 
e 内 存 管 理 
文件 输入 输出 
字符 串 操作 
数学 
日 期 和 时 间 
进程 控制 
信号 处 理 
网 络 套 接 字 
多 线程 
用 户 和 组 
系统 配置 
命名 服务 切换 
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6.2.3 缺 什么 


如 前 所 述 ，Bionic 是 专门 为 Android 平台 及 进行 移动 计算 而 设计 的 。Bionic 不 会 支持 
所 有 C 标准 库 的 函数 。Android NDK 文档 提供 了 缺失 功能 的 完整 列表 ; 然而， 可 以 在 实际 
的 头 文件 中 获取 这 些 信息 .Bionic 头 文件 可 以 放 到 Android NDK_HOME 目录 下 的 platforms/ 
android-<api-level>/arch-<architecture> /usr/include 中 。 

该 目录 下 的 每 个 头 文件 中 都 包含 一 个 部 分 ， 该 部 分 清楚 地 标明 了 缺失 函数 列表 。 如 程 
序 清单 6-1 所 示 ， 该 部 分 列 出 了 stdio.h 头 文件 中 缺失 的 函数 。 


程序 清单 6-1 ”Bionic 实现 的 缺失 函数 
#if 0 /* 缺失 自 BIONIC */ 


char *ctermid(char *); 

char *cuserid(char *); 

#endif /* 缺失 */ 

预 处 理 器 站 语句 被 用 来 禁用 头 文件 中 的 这 些 行 ， 而 相关 的 注释 则 表明 该 部 分 包含 了 缺 
失 函 数列 表 。 除 了 这 个 列表 ，Android NDK 文档 还 列举 了 一 些 通过 Bionic 展示 的 函数 ,但 
这 些 函 数 只 作为 存根 被 实现 ， 没 有 任何 功能 或 只 有 很 少 功能 。 


6.3 ”内 存 管理 


内 存 是 进程 最 基本 的 可 用 资源 。 对 于 Java 应 用 程序 来 说 ， 由 虚拟 机 来 管理 内 存 。 在 创 
建新 对 象 时 分 配 内 存 ， 未 使 用 的 内 存 会 通过 垃圾 回收 器 自动 归还 给 系统 。 然 而 在 原生 空间 
中 ， 应 用 程序 要 显 式 地 管理 它们 自己 的 内 存 。 在 原生 应 用 程序 开发 过 程 中 ， 有 效 地 管理 内 
存 是 非常 重要 的 ， 因 为 做 不 好 将 导致 系统 可 用 内 存 耗 尽 ， 并 且 会 在 总 体 上 严重 影响 应 用 程 
序 和 系统 稳定 性 。 


6.3.1 内 存 分 配 


C/C++ 程序 语言 支持 三 种 内 存 分 配方 式 : 

。 静态 分 配 : 适用 于 在 代码 中 定义 的 每 个 静态 和 全 局 变量 ， 静 态 分 配 在 应 用 程序 启 
动 时 自动 发 生 。 

e 自动 分 配 : 适用 于 每 个 函数 参数 和 局 部 变量 ， 自 动 分 配 在 包含 声明 的 复合 语句 被 
输入 时 发 生 ; 退出 复合 语句 时 所 分 配 的 内 存 被 自动 释放 。 

e 动态 分 配 : 静态 分 配 和 自动 分 配 都 假设 需要 的 内 存 大 小 和 范围 是 固定 的 ， 且 在 编 
译 时 就 被 定义 。 而 动态 分 配 则 在 事先 不 知情 的 情况 下 起 作用 ， 这 些 内 存 大 小 和 范 
围 的 分 配 取决 于 运行 时 因素 。 

本 节 将 介绍 基于 C 和 C++ 应 用 程序 的 动态 内 存 管理 。 
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6.3.2 C 语言 的 动态 内 存 管 理 


C 语言 不 提供 对 内 置 动态 内 存 管理 的 支持 。Bionic C 库 则 提供 了 一 组 函数 以 使 C 代码 
中 可 以 使 用 动态 内 存 。 


1. 在 C 中 分 配 动态 内 存 
C 语言 中 ， 可 以 在 运行 库 用 标准 C 库 函 数 malloc 分 配 动态 内 存 。 
void* malloc(size t size); 


为 了 用 这 个 函数 , 首先 应 该 包含 stdlib.h 标准 C 库 头 文件 。 如 程序 清单 6-2 所 示 , malloc 
只 有 一 个 参数 ， 分 配 的 内 存 大 小 以 字 节 为 单位 ， 并 返回 一 个 指向 新 分 配 内 存 的 指针 。 


程序 清单 6-2 C 代码 中 用 malloc 的 进行 动态 内 存 分 配 


/* 包含 标准 C 库 头 文件 。*/ 
#include < stdlib.h> 


/* 分 配 16 个 元 素 的 整 型 数组 .*/ 
int* dynamicIntArray = (int*) malloc(sizeof(int) * 16); 
if (NULL == dynamicIntArray) { 

/* 不 能 分 配 足 够 的 内 存 。*/ 


} else { 
/* 通过 整 型 指针 使 用 内 存 。*/ 
*dynamicIntArray = 0; 
dynamicIntArray[8] = 8; 


/* 释放 分 配 的 内 存 。*/ 

free (dynamicIntArray); 

dynamicIntArray = NULL; 
} 


提示 : 

因为 malloc 是 以 字 节 数 为 单位 分 配 内 存 的 , 所 以 可 以 用 C 关键 字 sizeof 来 提取 数据 类 
型 大 小 。 

如 果 所 请 求 的 内 存 大 小 不 能 满足 ，malloc 会 返回 NULL 以 说 明 这 种 情况 。 应 用 程序 在 
使 用 malloc 之 前 应 该 先 检查 其 返回 值 。 一 旦 分 配 , 普通 C 代码 便 可 通过 指针 使 用 动态 内 存 
直到 内 存 被 释放 。 

2. 在 C 语言 中 释放 动态 内 存 


当 不 再 需要 动态 内 存 时 ， 应 用 程序 应 该 显 式 地 释放 它 。 可 以 用 标准 C 库 函数 free 释放 
动态 内 存 。 
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void free(void* memory); 


free 函数 用 指向 之 前 分 配 的 动态 内 存 的 指针 作 参 数 并 释放 相应 内 存 ， 如 程序 清单 6-3 
所 示 。 


程序 清单 6-3 在 C 代码 中 用 free 释放 动态 内 存 
int* dynamicIntArray = (int*) malloc(sizeof(int) * 16); 


/* 使 用 分 配 的 内 存 ，*/ 


free (dynamicIntArray); 
dynamicIintArray = NULL; 


需要 注意 的 是 ， 在 函数 调用 后 即使 该 指针 指向 的 内 存 已 经 被 释放 ， 但 指针 的 值 并 不 改 


变 。 任 何 试图 使 用 该 无 效 指针 的 动作 都 会 引起 分 段 违规 。 为 了 避免 意外 使 用 无 效 指针 ， 最 
好 在 释放 指针 后 立刻 将 它 置 为 NULL。 


3. 改 变 C 语言 中 的 动态 内 存 分 配 
- 旦 分 配 内 存 ， 可 以 用 标准 C 库 提供 的 realloc 函数 来 改变 内 存 大 小 。 


void* realloc(void* memory, size t size); 
动态 分 配 的 内 存 大 小 可 以 根据 新 的 大 小 被 扩展 或 缩小 。realloc 函数 将 分 配 的 原始 动态 
内 存 作为 第 一 个 参数 ， 新 的 内 存 大 小 作为 第 二 个 参数 ， 如 程序 清单 6-4 所 示 。 


程序 清单 6-4 ”用 realloc 重新 分 配 已 分 配 的 动态 内 存 


int* newDynamicIntArray = (int*) realloc( 
dynamicIntArray, sizeof(int) * 32); 


if (NULL == newDynamicIntArray) { 
/* 不 能 重新 分 配 足 够 的 内 存 。*/ 


} a 
/* 更 新 内 存 指针 . */ 
dynamicIntArray = newDynamicIntArray; 
} 
realloc 函数 返回 指向 重新 分 配 的 内 存 的 指针 。 该 函数 可 以 通过 保存 内 容 将 原来 的 内 存 


移 到 一 个 新 的 位 置 上 ， 此 时 将 返回 新 位 置 。 如 果 函 数 调用 失败 ， 将 保留 原来 的 动态 内 存 分 
配 不 变 并 返回 NULL。 


6.3.3 ”C++ 的 动态 内 存 管理 


C++ 提供 了 对 动态 内 存 管理 的 内 置 支持 ， 可 以 采用 C++ 的 new 和 delete 关键 字 而 不 是 
标准 C 库 函 数 来 管理 动态 内 存 分 配 。 
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当 处 理 C++ 对 象 时 ,强烈 建议 用 C++ 关键 字 而 不 是 标准 C 库 提供 的 函数 。 和 标准 C 库 
函数 不 同 ，C++ 动 态 内 存 管理 关键 字 是 类 型 敏感 的 ， 且 它们 支持 C++ 对 象 生 命 周 期 。 除 了 
分 配 内 存 ，new 关键 字 也 调用 类 的 构造 函数 ;同样 的 ，delete 关键 字 在 释放 内 存 之 前 先 调 
用 类 的 析 构 函数 。 


1. C++ 中 动态 内 存 的 分 配 
用 new 关键 字 后 面 紧 跟着 数据 类 型 来 分 配 内 存 ， 如 程序 清单 6-5 所 示 。 
程序 清单 6-5 C++ 代 码 中 单个 元 素 的 动态 内 存 分 配 


int* dynamicInt = new int; 
if (NULL == dynamicInt) { 
/* 不 能 分 配 足够 的 内 存 。*/ 


etae | 
/* 使 用 已 分 配 的 内 存 ，*/ 


*dynamicInt = 0; 
} 
如 果 要 分 配 数 组 元 素 ， 数 组 元 素 的 个 数 要 用 方 括号 指定 ， 如 程序 清单 6-6 所 示 。 


程序 清单 6-6 ”C++ 代码 中 的 多 个 元 素 的 动态 内 存 分 配 


int* dynamicIntRrray = new int[16]; 
if (NULL == dynamicIntArray) { 
/* 不 能 分 配 足 够 的 内 存 。*/ 


于 SG 
/* 使 用 已 分 配 的 内 存 。*/ 
dynamicIntArray[8] = 8; 
让 
2. 释放 C++ 中 的 动态 内 存 


当 不 再 需要 动态 内 存 时 ， 应 该 由 应 用 程序 使 用 C++ 的 delete 关键 字 显 式 释放 ， 如 程序 
清单 6-7 所 示 。 


程序 清单 6-7 使 用 delete 关键 字 释 放 单个 元 素 的 动态 内 存 


delete dynamicInt; 
dynamicInt = 0; 


如 果 要 释放 数组 元 素 ， 应 该 用 C++ 的 关键 字 delete[]， 如 程序 清单 6-8 所 示 。 
程序 清单 6-8 ”使 用 delete[] 释 放 数组 动态 内 存 


delete[] dynamicIntArray; 
dynamicIntArray = 0; 
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注意 ， 要 正确 使 用 delete 关键 字 ， 否 则 会 导致 原生 应 用 程序 内 存 泄漏 。 
3. 改变 C++ 的 动态 内 存 分 配 


C++ 中 不 提供 重新 分 配 动态 内 存 的 内 置 支持 。 内 存 分 配 是 根据 数据 类 型 大 小 和 元 素 个 
数 来 定 的 。 如 果 应 用 程序 逻辑 上 需要 在 运行 时 增加 或 减少 元 素 个 数 ， 强 烈 建 议 使 用 适当 的 
标准 模板 库 (Standard Template Library，STL) 容 器 类 。 


4. 混合 内 存 函数 和 关键 字 


在 处 理 动态 内 存 时 ， 开 发 人 员 必 须 使 用 正确 的 函数 和 关键 字 对 。 通 过 malloc 分 配 的 内 
存 块 必须 用 free 关键 字 释 放 ， 同 样 的 ， 通 过 new 关键 字 分 配 的 内 存 块 必须 相应 地 由 delete 
关键 字 释 放 。 和 否则 会 导致 未 知 的 应 用 程序 行为 。 


6.4 标准 文件 1O 


原生 应 用 程序 可 以 通过 标准 C 库 提供 的 Standard File IO (stdio) 函 数 与 文件 系统 交互 。 
标准 C 库 提供 了 两 种 文件 IO: 

e 低级 1O: 原始 的 IO 函数 ， 有 更 完善 的 数据 源 控制 等 级 。 

。 流 1O: 更 高 级 别 的 、 可 缓冲 的 IO 函数 ， 更 适合 处 理 数据 流 。 

在 处 理 常规 文件 时 ， 基 于 IO 的 流 会 更 加 灵活 和 方便 。 本 节 将 重点 讲解 流 IO 函数 ， 
在 本 章 的 socket 通信 部 分 将 涵盖 部 分 低级 IO 函数 。 


6.4.1 标准 流 


有 三 种 预定 义 的 流 IO 可 以 在 原生 代码 通过 流 IO 立即 使 用 ， 这 些 流 分 别 表示 原生 应 
用 程序 的 标准 输入 输出 通道 ， 在 标准 IO 头 文件 中 它们 被 定义 为 下 列 变量 。 

(1) stdin: 应 用 程序 标准 输入 流 。 

(2) stdout: 应 用 程序 标准 输出 流 。 

(3) stderr: 应 用 程序 标准 错误 流 。 

由 于 Android 上 的 原生 应 用 程序 是 图 形 用 户 界面 (graphical user interface，GUD 下 运行 
的 一 个 模块 ， 这 些 流 并 不 是 很 有 用 。 当 与 旧 代 码 集成 时 ， 必 须 确保 任何 对 这 些 标准 流 的 使 
用 都 通过 GUI 妥善 处 理 。 正 如 第 5 章 中 “控制 台 日 志 ” 一 节 所 讲 的 ， 在 启动 应 用 程序 前 设 
置 log.redirect-stdio 系统 属性 可 以 将 stdout 和 stderr 流 导 向 Android 系统 日 志 。 


6.4.2 ”使 用 流 1/O 


流 IO 的 构造 和 函数 在 stdio.h 标准 C 库 头 文件 已 经 定义 过 。 为 了 在 原生 应 用 程序 中 使 
用 流 WO， 事先 应 该 包含 这 个 头 文件 ， 如 程序 清单 6-9 所 示 。 


程序 清单 6-9 ”包含 标准 I/O 头 文件 用 以 使 用 VO 流 


#include <stdio.h> 
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日 于 一 些 历史 原因 ， 在 标准 C 库 中 ， 表 示 流 的 数据 结构 类 型 被 称 为 FILE， 不 是 流 。 
一 个 FILE 对 象 保存 了 流 IO 连接 的 所 有 内 部 状态 信息 , 流 IO 函数 创建 并 维持 FILE 对 象 ， 
且 应 用 程序 代码 不 会 直接 处 理 该 对 象 。 


6.4.3 ”打开 流 


可 以 通过 流 IO 的 fopen 函数 打开 一 个 新 文件 或 现 有 文件 的 新 流 。fopen 函数 将 文件 名 
称 和 打开 类 型 作为 参数 ， 并 返回 一 个 流 指针 。 


FILE* fopen(const char* filename, const char* opentype); 


fopen 函数 的 第 二 个 参数 opentype 是 一 个 控制 文件 打开 方式 的 字符 串 。 它 应 该 由 以 下 
打开 类 型 的 其 中 一 个 开头 : 

er: 以 只 读 方式 打开 现 有 文件 。 

e。 w: 以 只 写 方式 打开 现 有 文件 。 如 果 该 文件 已 经 存在 ， 它 会 被 截断 ， 截 断后 文件 长 
度 为 0。 

ea: 以 附加 方式 打开 文件 。 保 存 文件 内 容 ， 新 输出 的 内 容 附加 到 文件 结尾 处 。 如 果 
该 文件 不 存在 ， 将 会 打开 一 个 新 的 文件 。 

e TIr+: 在 读 写 模式 下 打开 文件 。 

e w+: 在 读 写 模式 下 打开 文件 。 如 果 该 文件 已 经 存在 ， 它 会 被 截断 ， 截 断后 文件 长 
度 为 0。 

e a+: 打开 文件 进行 读 取 和 附加 。 在 读 取 时 ， 初 始 文件 的 位 置 被 设 定 在 开头 ， 而 附 
加 时 被 设 定 在 文件 结尾 。 


注意 : 
车 文件 是 以 r+、w+ 或 a+ 双 模式 打开 的 ， 在 读 写 转换 之 前 应 先 用 fllush 函数 刷新 组 
冲 区 。 


若 文件 不 能 以 请 求 的 模式 打开 ，fopen 函数 会 返回 一 个 NULL 指针 。 如 果 成 功 ， 一 个 
流 指 针 ( 一 个 FILE 指针 ) 会 被 返回 以 便 与 流 交 互 ， 如 程序 清单 6-10 所 示 。 
程序 清单 6-10 ”以 只 写 模式 打开 一 个 流 


#include <stdio.h> 


FILE* stream = fopen("/data/data/com.example.hellojni/test.txt", "w"); 
if (NULL == stream) 


7/* 写 文 件 打 不 开 . */ 
} 
else 


/* 使 用 流 .*/ 
/* 关闭 流 . */ 
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流 被 打开 后 ， 就 可 以 用 来 读 和 写 直到 它 被 关闭 。 
6.4.4 写 入 流 


流 1O 为 流 的 写 入 提供 了 4 个 函数 ， 本 节 将 简要 介绍 这 些 函 数 。 
1. 向 流 中 写 入 数据 块 


可 以 用 fwrite 函数 向 流 中 写 入 数据 块 。 
size 七 fwrite (const void* data, size t size, size t count, FILE* stream); 


如 程序 清单 6-11 所 示 ，fwrite 函数 从 缓冲 区 data 向 给 定 的 流 stream 中 写 count 个 大 小 
为 size 的 元 素 。 

程序 清单 6-11 用 fwrite 向 流 中 写 数 据 块 

| -二 "en "LE Oe NO 


size t count = sizeof(data) / sizeof(data[0]); 


/* 向 流 中 写 数据 . */ 


if (count ! = fwrite(data, sizeof(char), count, stream)) 
{ 


/* 向 流 中 写 数据 时 产生 错误 . */ 
} 


它 会 返回 实际 写 入 流 的 元 素 个 数 。 如 果 成 功 ,返回 的 值 应 该 等 于 count 所 指定 的 个 数 ; 
否则 表示 写 时 有 错误 。 


2. 向 流 中 写 入 字符 序列 

可 以 用 fputs 函数 向 流 中 写 入 以 null 结尾 的 字符 序列 。 

int fputs (Const char* data, FILE* stream); 

如 程序 清单 6-12 所 示 , fputs 函数 将 给 定 的 字符 序列 数据 写 入 名 为 stream 的 给 定 的 流 。 


程序 清单 6-12 用 fputs 向 流 中 写字 符 序 列 
/* 向 流 中 写字 符 序 列 .*/ 


if (EOF == fputs("hello\n", stream)) 
{ 

/* 向 流 中 写 数据 时 产生 错误 .*/ 
} 


如 果 字 符 序列 不 能 被 写 入 流 ，fputs 函数 返回 EOF。 
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3. 向 流 中 写 入 单个 字符 
可 以 用 fputc 函数 向 流 中 写 入 一 个 单个 字符 或 字 节 。 
int fputc(int c, FILE* stream); 


如 程序 清单 6-13 所 示 ，fpute 函数 在 写 入 给 定 的 流 之 前 ， 将 单个 字符 c 作为 一 个 整数 
并 将 其 转换 为 一 个 无 符号 字符 ， 该 流 命名 为 stream。 


程序 清单 6-13 ”用 fputc 向 流 中 写 一 个 单个 字符 


char c= 'c'; 


/* 向 流 中 写 一 个 单个 字符 . */ 
if (c ! = fputc(c, stream)) 
{ 
/+ 向 字符 串 中 写字 符 时 产生 错误 .*/ 
} 


如 果 字 符 不 能 被 写 入 流 ， 则 fpute 函数 返回 EOF， 否则 会 返回 字符 本 身 。 
4. 向 流 中 写 入 有 格式 的 数据 

可 以 用 fprintf 函数 在 给 定 的 流 中 格式 化 并 输出 可 变数 量 的 参数 。 

int fprintf (FILE* stream, const char* format, ...); 


在 所 引用 的 格式 中 包括 一 个 指向 流 的 指针 、 格 式 字 符 串 和 可 变数 量 的 参数 。 格 式 字符 
串 由 普通 字符 和 格式 说 明 符 混合 而 成 。 其 中 的 普通 字符 被 原样 传送 到 流 中 ， 格 式 说 明 符 使 
fprintf 函数 格式 化 并 相应 地 将 给 出 的 参数 写 入流 中 。 使 用 最 频繁 的 说 明 符 有 : 
。 %d、%i: 将 整数 参数 格式 化 为 有 符号 十 进 制 数 
%u: 将 无 符号 整数 格式 化 为 无 符号 十 进 制 数 
%o: 将 无 符号 整数 参数 格式 化 为 八进制 
%x: 将 无 符号 整数 参数 格式 化 为 十 六 进 制 
%e: 将 整数 参数 格式 化 为 单个 字符 
%f: 将 双 精 度 参 数 格式 化 为 浮 点 数 
%e: 将 双 精 度 参 数 格式 化 为 固定 格式 
%s: 打印 给 出 的 NULL 结尾 字符 数组 
%p: 打印 给 出 的 指针 作为 内 存 地 址 
。 %%: 写 入 一 个 % 字 符 
如 程序 清单 6-14 所 示 ，fprintf 函数 提供 的 参数 顺序 和 类 型 应 该 与 格式 字符 串 中 的 说 明 
符 相 匹配 。 


程序 清单 6-14 ”向 流 中 写 带 格式 的 数据 


/* 写 带 格 式 的 数据 . */ 
if (0 > fprintf(stream, "The %s is %d.", "number", 2)) 
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{ 
/* 写 带 格式 的 数据 时 产生 错误 . */ 
} 
fprintf 函数 返回 写 入 流 中 的 字符 个 数 。 在 出 错 的 情况 下 ， 它 返回 一 个 负数 。 关 于 格式 
字符 串 的 更 多 信息 ， 包 括 字 符 串 格式 说 明 符 和 修改 符 的 完整 列表 ， 请 参见 http://pubs. 
opengroup.org/onlinepubs/009695399/functions/fprintf.html 中 的 fprintf 使 用 说 明 页 。 


5. 刷新 缓冲 区 


流 IO 积累 写 入 的 数据 并 异步 地 将 其 传送 至 底层 文件 中 , 而 不 是 立即 将 数据 写 入 文件 。 
类 似 的 ， 流 IO 从 文件 中 以 块 的 方式 读 取 数 据 而 不 是 逐个 字符 地 读 ， 这 就 是 所 谓 的 缓冲 。 
刷新 缓冲 区 意味 着 将 所 有 积累 的 数据 传送 到 底层 文件 中 。 在 以 下 情况 下 刷新 会 自动 
进行 : 
。 应 用 程序 正常 终止 
。 在 行 缓冲 时 写 入 新 行 
。 当 绥 冲 区 已 满 
。 当 流 被 关闭 
流 IO 也 提供 了 鱼 ush 函数 使 得 应 用 程序 可 以 在 需要 时 手动 刷新 缓冲 区 。 


int fflush(FILE* stream); 


如 程序 清单 6-15 所 示 ， 角 ush 函数 以 流 指针 为 参数 并 且 刷 新 输出 缓冲 区 。 


程序 清单 6-15 用 人 ush 函数 刷新 缓冲 区 


char itall = { "hs “es The “I Mo No? 
size t count = sizeof(data) / sizeof(data[0]); 


/* 向 流 中 写 数据 .。*/ 


fwrite (data, sizeof (char), count, stream); 


/* 刷新 输出 缓冲 区 ，*/ 
if (EOF == fflush(stream) ) 
{ 

/* 清空 缓冲 区 时 产生 错误 .*/ 
} 


如 果 缓 冲 区 不 能 写 入 实际 的 文件 ，fhush 函数 返回 EOF; 否则 返回 0。 
6.4.5 流 的 读 取 


和 写 入 相似 ， 流 IO 为 流 的 读 取 提供 了 4 个 函数 。 
1. 从 流 中 读 取 数 据 块 
可 以 用 fread 函数 从 流 中 读 取 数据 块 。 
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size t fread(void* data, size t size, size t count, FILE* stream); 


如 程序 清单 6-16 所 示 ，fread 函数 从 给 定 的 流 stream 中 读 取 count 个 size 大 小 的 元 素 
并 放 入 缓冲 区 data 中 ， 它 返回 实际 读 取 的 元 素 个 数 。 


程序 清单 6-16 ”从 流 中 读 取 4 个 字符 的 块 数据 


char buffer[5]; 
size t count = 4; 


/* 从 流 中 读 取 4 个 字符 . */ 
if (count ! = fread(buffer, sizeof(char), count, stream)) 
{ 
/* occurred 从 流 中 读数 据 时 产生 错误 */ 
} 
else 
{ 
/* 以 空 结尾 。*/ 
buffer[4] = NULL; 


/* 输出 缓冲 区 */ 
MY LOG INFO("read: %s", buffer); 
} 


在 成 功 的 情况 下 ， 返 回 的 元 素 个 数 应 该 等 于 传递 给 count 的 值 。 

2. 从 流 中 读 取 字 符 序列 

可 以 用 fgets 函数 从 给 定 的 流 中 读 取 以 换行 符 结尾 的 字符 序列 。 

char* fgets (charx buffer, int count, FILE* Stream) 

如 程序 清单 6-17 所 示 , fgets 函数 从 给 定 的 流 stream 中 最 多 读 取 count-1 个 字符 再 加 上 
换行 符 ， 并 将 新 行 的 字符 内 容 放 入 字符 数组 buffer 中 。 

程序 清单 6-17 ” 读 取 一 个 换行 符 结尾 的 字符 序列 


char buffer[1024]; 


/* 从 流 中 读 取 换行 符 结尾 的 字符 序列 .。*/ 
if (NULL == fgets (buffer, 1024, stream)) 
{ 
/* occurred 读 取 流 时 产生 错误 . */ 
} 
else 
{ 
MY _ LOG INFO("read: %s", buffer); 
} 


成 功 时 返回 缓冲 区 指针 ， 否 则 返回 NULL 指针 。 
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3. 从 流 中 读 取 单个 字符 
fgetc 函数 可 以 从 流 中 读 取 单 个 无 符号 字符 。 
int fgetc(FILE* stream); 


如 程序 清单 6-18 所 示 ，fgetc 函数 从 流 中 读 取 单个 字符 并 返回 一 个 整数 。 


程序 清单 6-18 ”从 流 中 读 取 单个 字符 


unsigned char ch; 
int result; 


/* 从 流 中 读 取 单 个 字符 .*/ 
result = fgetc(stream); 
if (EOF == result) 
{ 
/* occurred 从 流 中 读 取 时 产生 错误 .*/ 
} 


else 


/+ 获取 实际 字符 .*/ 


ch = (unsigned char) result; 


} 
如 果 设置 了 流 的 文件 结束 指示 符 ， 则 返回 EOF。 
4. 从 流 中 读 取 格 式 数 据 


可 以 用 fscanf 函数 从 流 中 读 取 格式 数据 。 它 的 工作 方式 和 fprintf 函数 相似 ， 不 过 它 根 
据 给 定 的 格式 读 取 数 据 并 放 入 提供 的 参数 中 。 


int fscanf (FILE* stream, const char* format, ...); 


函数 的 参数 包括 指向 流 的 指针 、 格 式 字符 串 和 格式 字符 串 中 指定 的 可 变数 量 参 数 。 格 
式 字符 串 由 普通 字符 和 格式 说 明 符 混合 而 成 。 其 中 的 普通 字符 用 来 指定 必须 出 现在 输入 中 
的 字符 ; 格式 说 明 符 使 fscanf 函数 读 取 并 将 数据 放 在 给 定 的 参数 中 ， 使 用 最 频繁 的 说 明 
符 有 : 
%d、%i: 读 取 一 个 有 符号 十 进 制 数 
%u: 读 取 一 个 无 符号 十 进 制 数 
%o: 读 取 一 个 八进制 数 无 符号 整数 
%x: 读 取 一 个 十 六 进 制 数 无 符号 整数 
%e: 读 取 单 个 字符 
%f: 读 取 一 个 浮 点 数 
%e: 读 取 一 个 固定 格式 的 浮 点 数 
%s: 扫描 一 个 字符 串 
%%: 转 义 % 字 符 
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如 程序 清单 6-19 所 示 , 给 fscanf 函数 提供 的 参数 顺序 和 类 型 应 该 与 格式 字符 串 中 的 说 
明 符 相 匹配 。 
程序 清单 6-19 ”从 流 中 读 取 带 格式 的 数据 
char s[5]; 


int i; 


/* 流 中 有 "The number is 2" */ 
/* 读 带 格式 的 数据 . */ 


if (2 ! = fscanf(stream, "The %s is %d", s, &i)) 


/* 读 带 格式 的 数据 时 产生 错误 .*/ 
} 


车 成 功 ，fscanf 函数 返回 读 取 的 项 目 个 数 。 若 有 错误 ， 则 返回 EOF。 有 关 格 式 字 符 串 
和 所 有 说 明 符 及 其 他 修改 符 的 列表 信息 , 可 在 fscanf 手册 中 找到 : http://pubs.opengroup.org/ 
onlinepubs/009695399/functions/fscanf.html。 


5. 检查 文件 结尾 
从 流 中 读 取 时 ， 如 果 已 经 设置 了 流 的 文件 结束 指示 符 ， 可 以 用 feof 函数 检查 。 


int feof (FILE* stream); 
如 程序 清单 6-20 所 示 , 如 果 已 到 达 文 件 结尾 , 那么 feof 函数 会 将 流 指针 作为 一 个 参数 
并 返回 一 个 非 零 值 ， 如 果 可 以 从 流 中 读 取 更 多 数据 ， 则 返回 零 。 
程序 清单 6-20 ”从 流 中 读 取 字符 串 直到 文件 尾 
char buffer[1024]; 
/* 直到 文件 尾 . */ 
while (0 == feof(stream)) 
{ 
/* 读 取 并 输出 字符 串 。*/ 
fgets (buffer, 1024, stream); 


MY _ LOG INFO("read: %s", buffer); 
} 


6.4.6 ”搜索 位 置 
可 以 用 fseek 函数 修改 流 中 的 位 置 。 


int fseek(EFILE* stream, long offset, int whence); 


fseek 函数 有 三 个 参数 : 流 指针 、 相 对 偏 移 量 和 表示 相对 偏 移 量 参照 点 的 位 置 参 量 。 位 
置 参量 可 以 取 以 下 三 个 值 : 


e SEEK SET: 偏 移 量 相 对 于 流 的 开头 。 
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e SEEK_CUR: 偏 移 量 相对 于 当前 位 置 。 
e SEEK FEND: 偏 移 量 相对 于 流 结尾 。 
程序 清单 6-21 所 示 的 示例 代码 写 入 了 4 个 字符 , 倒 回 了 4 个 流 字 节 且 用 不 同 的 字符 集 
重 写 了 它们 。 
程序 清单 6-21 ” 倒 回 4 个 流 字 节 
/* 写 入 流 中 . */ 


fputs("abcd", stream); 


/* 倒 回 4 个 字 节 . */ 


fseek (stream, -4, SEEK CUR); 


/* 用 efgh 重 写 了 abcd. */ 
fputs ("efgh", stream); 


在 示例 代码 中 省 略 了 错误 检查 。 如 果 该 操作 成 功 ， 则 fseek 函数 返回 零 ， 否 则 返回 非 
零 值 表示 操作 失败 。 


6.4.7 ”错误 检查 
大 多 数 流 VO 函数 返回 EOF 来 表示 错误 并 报告 文件 结尾 。 如 果 在 之 前 的 操作 中 发 生 了 
错误 ， 则 可 以 用 ferror 函数 进行 错误 检查 。 


int ferror (FILE* stream); 


如 程序 清单 6-22 所 示 ， 如 果 给 定 流 的 错误 标志 已 被 设置 为 给 定 流 ， 那 么 ferror 函数 会 
返回 一 个 非 零 值 。 
程序 清单 6-22 ”检查 错误 
/* 检查 错误 ，*/ 
if (0 ! = ferror(stream) ) 
{ 
/* 前 一 次 请 求 中 产生 错误 .*/ 
} 


6.4.8 关闭 流 


可 以 用 felose 函数 关闭 流 ， 此 时 任何 缓冲 的 输出 都 会 被 写 入 流 中 ， 而 任何 缓冲 的 输入 
都 会 被 丢弃 。 


int fclose(FILE* stream); 


felose 函数 以 流 指针 作为 参数 。 如 果 成 功 ， 则 返回 零 ， 如 果 在 关闭 过 程 中 发 生 错 误 ， 
则 返回 EOF， 如 程序 清单 6-23 所 示 。 
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程序 清单 6-23 用 fclose 函数 关闭 流 


if (0 ! = fclose(stream)) 


/* 关 闭 流 时 产生 错误 . */ 
} 


错误 有 可 能 表示 由 于 磁盘 空间 不 足 ， 缓 冲 的 输出 不 能 被 写 入 到 流 中 。 检 查 fclose 函数 
返回 的 值 是 一 个 很 好 的 做 法 。 


6.5 与 进程 交互 


Bionic 允许 原生 应 用 程序 启动 并 与 其 他 原生 进程 交互 。 原 生 代 码 可 以 执行 shell 命令 ; 
它 可 以 在 后 台 执行 一 个 进程 并 与 之 通信 ， 本 节 将 简要 介绍 其 中 的 一 些 重要 的 函数 。 


6.5.1 执行 shell 命令 


可 以 用 system 函数 向 shell 传递 命令 。 为 了 使 用 这 个 函数 , 应 该 先 包含 stdlib.h 头 文件 。 
#include <stdlib.h> 

如 程序 清单 6-24 所 示 ， 该 函数 阻塞 了 原生 代码 直到 命令 执行 结束 。 

程序 清单 6-24 ”用 系统 函数 执行 Shell 命令 


int result; 


/* 执行 shell 命令 . */ 
result = system("mkdir /data/data/com.example.hellojni/temp"); 
if (一 1 == result || 127 == result) 
{ 
/+ 执行 shell 命令 失败 . */ 
} 


6.5.2 与 子 进程 通信 


system 命令 不 为 原生 应 用 程序 提供 接收 进程 的 输出 或 者 给 运行 的 进程 发 送 命令 的 通信 
通道 ， 命 令 执行 结束 前 原生 代码 一 直 在 等 待 。 某 些 情况 下 ， 原 生 代码 和 执行 的 进程 间 需 要 
一 个 通信 信道 。 

可 以 用 popen 函数 在 父 进 程 和 子 进程 之 间 打 开 一 个 双向 通道 。 为 了 使 用 这 个 函数 ， 首 
先 应 该 先 包含 stdioh 标准 头 文件 。 


FILE *popen (const char* command, const char* type); 


popen 函数 把 将 要 执行 的 命令 以 及 要 求 的 通信 信道 类 型 作为 参数 ， 返 回 一 个 流 指 针 。 
若 出 现 错误 ， 则 返回 NULL。 如 程序 清单 6-25 所 示 ， 在 本 章 前 面 提 到 过 的 IO 流 函 数 就 可 
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以 与 一 个 文件 交互 的 方式 和 子 进程 进行 通信 。 
程序 清单 6-25 向 ls 命令 打开 一 个 通道 并 且 打印 输出 


#include <stdio.h> 
FILE* stream; 


/* 向 1s 命令 打开 一 个 只 读 通道 .*/ 
stream = popen("ls", "r"); 
if (NULL == stream) 
{ 
MY _LOG ERROR ("Unable to execute the command."); 
} 
else 
{ 
char buffer[1024]; 
int status; 


/* 从 命令 输出 中 读 取 每 一 行 。*/ 
while (NULL ! = fgets (buffer, 1024, stream) 
{ 
MY _ LOG INFO("read: %s", buffer); 
} 


/* 关闭 通道 并 获取 其 状态 . */ 

status = pclose(stream); 

MY LOG_INFO("process exited with status %d", status); 
} 


注意 : 
默认 情况 下 ，popen 流 是 完全 缓冲 的 。 需 要 时 可 以 使 用 fush 函数 刷新 缓冲 区 。 


子 进 程 执行 完成 后 ， 应 该 用 pclose 函数 将 流 关 闭 。 
int pclose(FILE* stream); 


它 将 流 指针 作为 参数 并 等 待 子 程序 终止 ， 最 后 返回 exit 状态 。 


6.6 ”系统 配置 


Android 平台 以 简单 的 键 - 值 对 的 方式 保存 系统 属性 。Bionic 提供 了 一 组 函数 允许 原生 
应 用 程序 查询 系统 属性 。 为 了 使 用 这 些 函 数 ， 首 先 应 该 包含 系统 属性 头 文件 。 


#include <sys/system properties.h> 


系统 属性 头 文件 声明 了 必要 的 结构 和 函数 。 每 个 系统 属性 都 包含 不 超过 PROP_NAME_ 
MAX 个 字符 的 属性 名 和 不 超过 PROP_ VALUE _MAX 个 字符 的 属性 值 。 
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6.6.1 通过 名 称 获取 系统 属性 值 


The _ system_property_get 函数 可 用 于 根据 名 字 查 看 系统 属性 。 
int _ system property _ get (Const char* name, char* Value) 7 


如 程序 清单 6-26 所 示 , 它 将 null 结尾 的 属性 值 复制 到 所 提供 的 值 指针 并 返回 值 的 大 小 。 
复制 的 总 字 节 数 不 会 超过 PROP VALUE MAX。 


程序 清单 6-26 ”通过 名 称 获取 系统 属性 值 


char Value[PROP VALUE MAX]; 


/* 获取 product model 系统 属性 . */ 

if (0 一 _ system property get("ro.product.model", value)) 
/* 系统 属性 未 找到 或 值 为 室 .*/ 

} 

else 

{ 


MY _ LOG INFO("product model: %s", value); 
} 


如 果 属 性 没 定义 ， 返 回 大 小 为 0 的 值 。 
6.6.2 ”通过 名 称 获取 系统 属性 


可 以 用 _ system_property_find 函数 获取 一 个 指向 系统 属性 的 直接 指针 。 
const prop info* _ system property find(const char* name); 


它 通过 名 称 搜索 系统 属性 ， 如 果 找 到 指定 属性 ， 就 会 返回 一 个 指向 它 的 指针 ; 否则 返 
回 NULL。 在 系统 的 生命 周期 内 返回 的 指针 一 直 有 效 ， 且 它 可 以 缓存 以 方便 日 后 查询 。 如 
程序 清单 6-27 所 示 ， 可 以 用 _system_property_read 函数 从 该 指针 中 获取 属性 值 。 


程序 清单 6-27 ”通过 名 称 获取 系统 属性 


const prop_ info* property; 


/* 获取 product model 系统 属性 . */ 
Property = __ system property find("ro.product.model"); 
if (NULL == property) 
{ 
/* 系统 属性 未 找到 . */ 
} 
else 
{ 
char name [PROP NAME MAX]; 
char value[PROP VALUE MAX]; 
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/* 获取 系统 属性 名 称 和 值 . */ 
if (0 == _ system property read(property, name, value)) 
{ 
MY LOG INFO("%s is empty."); 
} 


elae 
{ 
MY LOG INFO("%s: %s", name, value); 
} 
} 
_ system property_read 函数 用 指向 系统 属性 的 指针 和 另外 两 个 指向 返回 的 系统 属性 
名 称 和 属性 值 的 字符 数组 指针 作 参 数 。 


int _ system property_read (Const prop info* pi, char* name, char* Value) 7 


它 将 以 null 结尾 的 属性 值 复制 到 提供 的 值 指针 中 ， 并 返回 值 的 大 小 。 复 制 的 字符 总 数 
不 会 超过 PROP_VALUE_MAX。 名称 参 数 是 可 选 的 ， 如果 提 供 了 一 个 字符 数组 ， 它 会 将 系 
统 属性 名 称 复制 到 给 定 的 值 指针 中 。 复 制 的 字符 总 数 不 会 超过 PROP NAME_MAX。 


6.7 用户 和 组 


Linux 内 核 是 为 多 用 户 平台 设计 的 。 虽 然 Android 一 定 是 被 单个 用 户 使 用 , 但 它 仍然 要 
利用 基于 用 户 的 权限 模型 。 
。 Android 在 虚拟 机 沙 箱 里 运行 应 用 程序 ， 且 在 系统 上 将 它们 当 作 不 同 的 用 户 对 待 。 
通过 单纯 地 依赖 基于 用 户 的 权限 模型 ，Android 可 以 通过 阻止 应 用 程序 访问 其 他 应 
用 程序 的 数据 和 内 存 来 达到 保证 系统 安全 的 目的 。 
e， 服务 和 硬件 资源 也 是 通过 基于 用 户 的 权限 模型 来 保护 的 。 每 个 资源 都 有 自己 的 保 
护 组 。 在 应 用 程序 部 署 的 过 程 中 ， 应 用 程序 请 求 访问 这 些 资源 。 如 果 应 用 程序 不 
是 正确 的 资源 组 成 员 ， 它 就 不 能 访问 任何 额外 的 资源 。 
Bionic 为 用 户 和 组 信息 函数 提供 基本 支持 ， 这 些 函 数 大 多 数 都 是 只 有 很 少 功能 或 者 没 
有 功能 的 存根 。 本 节 讲 解 一 些 重要 函数 ， 为 了 使 用 这 些 函 数 ， 应 该 首先 包含 unistd.h 标准 
头 文件 。 


#include <unistd.h> 


6.7.1 获取 应 用 程序 用 户 和 组 ID 


每 一 个 安装 好 的 应 用 程序 都 从 10 000 开始 获取 自己 的 用 户 ID 和 组 卫 。 较 低 的 D 用 于 
系统 服务 ， 可 以 用 getuid 函数 获取 当前 应 用 程序 的 用 户 一 ， 如 程序 清单 6-28 所 示 。 


程序 清单 6-28 用 getuid 函数 获取 应 用 程序 的 用 户 ID 


uid t uid; 
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/* 获取 应 用 程序 的 用 户 ID. */ 
uid = getuid() 


MY LOG INFO("Application User ID is %u", uid); 

和 用 户 ID 相似 ,当前 应 用 程序 的 组 ID 可 以 用 getgid 函数 获取 , 如 程序 清单 6-29 所 示 。 
程序 清单 6-29 用 getgid 函数 获取 应 用 程序 的 组 ID 

gid t gid7 


/* 获 取 应 用 程序 的 组 ID. */ 
gid = getgid(); 


MY _LOG INFO("Application Group ID is %u", gid); 
6.7.2 ”获取 应 用 程序 用 户 名 


每 一 个 安装 好 的 应 用 程序 都 获取 分 配给 用 户 的 用 户 名 ， 用 户 名 以 “app_” 开 头 ， 后 接 
应 用 程序 号 。 例 如 ， 有 用 户 D 为 10 040 的 应 用 程序 的 用 户 名 是 app_40。 通 过 getlogin 函数 
获取 用 户 名 ， 如 程序 清单 6-30 所 示 。 


程序 清单 6-30 ”用 getlogin 函数 获取 应 用 程序 的 用 户 名 
char* username; 


/* 获取 应 用 程序 的 用 户 名 .。*/ 


username = getlogin(); 


MY_LOG INFO("Application user name is %s", username); 


6.8 ”进程 间 通 信 


为 了 避免 拒绝 服务 攻击 和 内 核资 源 泄漏 ，Bionic 不 提供 对 System V 的 进程 间 通 信 
(inter-process communication，IPC) 的 支持 。 虽 然 不 支持 System V IPC，Android 平台 结构 利 
用 自己 独 有 的 Binder 使 用 了 大 量 的 IPC。Android 应 用 程序 通过 Binder 接口 与 系统 、 服 务 
以 及 其 他 应 用 间 进 行 交互 。 在 本 书 编写 时 , Bionic 不 提供 任何 可 以 使 原生 应 用 程序 与 Binder 
接口 交互 的 官方 API。 目 前 ， 只 能 通过 Android Java APIs 访问 Binder 接口 。 


6.9 小 结 


本 章 深入 学 习 了 Bionic， 它 是 Google 为 Android 操作 系统 提供 的 BSD 标准 C 库 的 衍 
生 库 。 我 们 学 习 了 通过 Bionic 访问 到 原生 应 用 程序 的 标准 C 库 函数 ， 例 如 内 存 管理 、 标 准 
IO、 进 程控 制 、 系 统 配置 以 及 用 户 和 组 管理 函数 。 本 章 也 提 到 了 API，Bionic 也 为 原生 应 
用 程序 提供 多 线程 和 联网 API。 我 们 将 会 在 后 面 的 各 章 中 分 别 讲解 这 些 API。 
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线程 是 让 单个 进程 并 发 执行 多 个 任务 的 机 制 。 它 是 共享 同一 个 父 进程 的 内 存 和 资源 的 
轻 量 级 进程 ， 一 个 进程 可 以 包括 多 个 并 行 执行 的 线程 。 作 为 同一 个 进程 的 一 部 分 ， 线 程 之 
间 可 以 彼此 通信 并 共享 数据 。Android 支持 Java 和 原生 代码 中 的 线程 。 本 章 将 学 习 用 于 将 
并 发 编程 附加 到 原生 代码 中 的 不 同 策略 和 API， 主 要 包含 以 下 内 容 : 

e Java 与 POSIX 线程 
线程 同步 
控制 线程 的 生命 周期 
线程 优先 级 及 调度 策略 
原生 线程 与 Java 的 交互 


7.1 创建 线程 示例 项 目 


在 详细 阐述 包含 多 线程 的 原生 代码 之 前 ， 需 要 先 创 建 一 个 简单 的 示例 应 用 程序 作为 测 
试 平台 。 该 示例 应 用 程序 包括 以 下 内 容 : 
e 支持 原生 代码 的 Android 应 用 项 目 
e 一 个 简单 GUI， 用 于 定义 线程 数 和 每 个 worker 和 迭代 的 次 数 、 启 动 线程 的 按钮 、 运 
行 时 显示 原生 worker 进度 信息 的 文本 视图 
e 模仿 运行 时 间 较 长 任务 的 原生 worker 函数 
在 学 习 本 章 时 ， 我 们 将 扩展 该 示例 应 用 程序 来 说 明 原生 代码 中 的 多 线程 技术 和 API。 


7.1.1 创建 Android 项 目 


开始 创建 一 个 新 的 Android 应 用 项 目 。 
(1) 打开 Eclipse IDE， 在 菜单 栏 中 选择 File | New | Other 打开 New 对 话 框 ， 如 图 7-1 
所 示 。 
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Select a wizard 
Create an Android Application Proiect 


Wizards: 
ltype filter text | 
BE Android = 
-区 Android Activity 
ned potcation Proicol 
-Android Icon Set 
”一 国 Android 0bieet [ 


图 7-1 New 对 话 框 


(2) 在 向 导 列 表 中 展开 Android 类 别 。 
(3) 在 子 列表 中 选择 Android Application Project。 
(4) 单 击 Next 按钮 打开 New Android App 向 导 ， 如 图 7-2 所 示 。 


访 New Android App 


New Android Application 
Creates a new Android Application 


Application Name:©|Threads 


Proiect Name:9|Threads 


Package Name:0|com.apress.threads 


Build SDK:0[Android 4.0 [APL 14] 


Minimum Required SDK:0|API 8: Android 2.2 [Froyo) 可 


7-2 New Android App 对 话 框 


(5) 将 Application Name 设置 为 Threads。 

(6) 将 Project Name 设置 为 Threads。 

(7) 将 Package Name 设置 为 com.apress.threads。 
(8) 将 Build SDK 设置 为 Android 4.0。 

(9) 将 Minimum Required SDK 设置 为 API 8。 
(10) 单 击 Next 按钮 继续 。 

(11) 单 击 Next 按钮 让 启动 图 标 保持 默认 设置 。 
(12) 选择 Create activity。 

(13) 在 模板 列表 中 选择 Blank Activity。 

(14) 单 击 Next 继续 。 

(15) 在 New Blank Activity 步骤 中 ， 通 过 单 击 Finish 按钮 接受 默认 值 。 
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7.1.2 添加 原生 支持 


为 了 使 用 原生 代码 ， 需 要 将 Native support 添加 到 新 的 Android 项 目 中 。 打 开 Project 
Explorer 视图 , 右 击 Threads 项 目 ,并 在 上 下 文 菜单 中 选择 Android Tools | Add Native Support。 
如 图 7-3 所 示 ， 将 弹出 Add Android Native Support 对 话 框 。 


Add Android Native Support 
Settings for generated native components for proiect 


Library Name: lib [Threads -s0 


图 7-3 添加 Android Native Support 对 话 框 


将 Library Name 设置 为 Threads， 并 单 击 Finish 按钮 。Native code support 将 被 添加 到 
项 目 中 。 


7.1.3 ”声明 字符 串 资源 


应 用 程序 的 用 户 接口 与 一 组 字符 串 资源 相关 。 打 开 Project Explorer 视图 ， 展 开 用 于 保 
存 资源 的 res 目录 。 展 开 values 子 日 录 ， 双 击 strings.xml 在 编辑 器 中 打开 字符 串 资源 。 用 
程序 清单 7-1 所 示 的 内 容 替 换 字符 串 资源 的 内 容 。 


程序 清单 7-1 res/values/strings.xml 文件 内 容 


<resources> 
<string name="app_name">Threads</string> 
<string name="menu settings">Settings</string> 
<string name="title activity main">Threads</string> 
<string name="threads edit">Thread Count</string> 
<string name="iterations edit">Iteration Count</string> 
<string name="start button">start Threads</string> 
</resources> 


7.1.4 创建 简单 的 用 户 界 面 


用 户 程序 需要 有 一 个 简单 的 用 户 界面 ， 其 中 需要 包括 以 下 内 容 : 输入 线程 数 和 夫 代 次 
数 的 字段 、 线 程 启动 按钮 和 监控 线程 进度 的 文本 视图 (如 图 7-4 所 示 )。 
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面 A410 
© Threads 


Thread Count 


lteration Count 


Start Threads 


图 7-4 示例 应 用 的 简单 用 户 接口 


打开 Project Explorer 视图 ， 展 开 res 目录 下 的 layout 子 目 录 。 双 击 activity_main.xml 
布局 文件 在 编辑 器 中 打开 它 ， 用 程序 清单 7-2 所 示 的 内 容 蔡 换文 件 原来 的 内 容 。 


程序 清单 7-2 res/layout/activity_main.xml 文件 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match Parent" 
android:orientation="vertical" > 


<EditText 
android:id="@+id/threads edit" 
android:layout width="match parent" 
android:layout height="wrap_ content" 
android:ems="10" 
android:hint="@string/threads edit" 
android:inputType="number" > 


<requestFocus /> 
</EditText> 


<EditText 
android:id="@+id/iterations edit" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:ems="10" 
android:hint="@string/iterations edit" 
android:inputType="number" /> 


<Button 
android:id="@+id/start button" 
android:layout width="wrap_content" 
android:layout height="wrap content™" 
android:text="@string/start button" /> 


<SscrollView 
android:id="@+id/scrollViewl" 
android:layout width="match parent" 
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android:layout height="wrap content" > 


<TextView 
android:id="@+id/log view" 
android:1layout width="match parent" 
android:layout height="wrap content" /> 


</SscrollView> 


</LinearLayout> 


7.1.5 实现 Main Activity 


main activity 将 展示 第 7.1.4 节 定 义 的 用 户 接口 ， 它 将 激活 用 户 接 口 以 便于 在 运行 时 配 
置 并 控制 线程 和 workers。 在 详细 介绍 main activity 中 提供 的 函数 之 前 ,打开 Project Explorer 
视图 ， 展 开 src 目录 ， 并 且 选 择 Java 包 com.apress.thread。 双 击 MainActivity.java 文件 ， 用 
程序 清单 7-3 所 示 的 内 容 替 换文 件 原来 的 内 容 。 


程序 清单 7-3 ”src/com/apress/threads/MainActivity.java 文件 内 容 


package com.apress.threads; 


import android.app.Activity; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.EditText; 

import android.widget.TextView; 


/女友 

* Main activity. 

大 

* @author Onur Cinar 

be 

public class MainActivity extends Activity { 
/** Threads edit. */ 
private EditText threadsEdit; 


/** Iterations edit. */ 
private EditText iterationsEdit; 


/** Start button. */ 
private Button startButton; 


/** LOog view. */ 
private TextView logView; 


Q@Override 
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public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 7 
setContentView(R.layout.activity main); 


// 初始 化 原生 代码 


nativeInit(); 


threadsEdit = (EditText) findViewById(R.id.threads edit); 
iterationsEdit = (EditText) findViewById(R.id.iterations edit); 
startButton = (Button) findViewById(R.id.start button); 
logView = (TextView) findViewById(R.id.log view); 


startButton.setonClickListener (new OnClickListener() { 
public void onClick(View view) { 
int threads = getNumber (threadsEdit, 0); 
int iterations = getNumber (iterationsEdit, 0); 


if (threads > 0 && iterations > 0) { 
startThreads (threads, iterations); 


QOverride 
protected void onDestroy() { 
// 释 放 原生 资源 


nativeFree(); 


super.onDestroy() 7 
} 
/J 
* 原生 消息 回调 . 


* Q@param message 
原生 消息 . 
wx 
private void onNativeMessage (final String message) { 
FunOonUiThread (new Runnable() { 
public void run() { 
logView.append (message); 
logView.append ("\n"); 


Fr 


/** 
* 以 integer 格式 获取 编辑 文本 的 值 。If the value 
* 如 果 值 为 empty 或 计数 不 能 分 析 ， 则 返回 默认 值 
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* @param editText edit text. 

* @param defaultValue default value. 

* @return numeric value. 

private static int getNumber (EditText editText, int defaultValue) { 
int value; 


try 1 

value = Integer.parseInt (editText .getText () .tostring()); 
} catch (NumberFormatException e) { 

value = defaultValue; 


return value; 


/** 
* 启动 给 定 个 数 的 线程 进行 达 代  * 


* @param threads thread count. 

* @param iterations iteration count. 

jad 

private void startThreads (int threads, int iterations) { 


// 在 讲解 本 章 时 将 实现 该 方法 


/** 
* 初始 化 原生 代码 . 

Wf 

private native void nativeInit(); 

/* 太 

* 释 放 原生 资源 . 

wp 

private native void nativeFree(); 

/太太 

* 原生 worker. 

于 

* Q@param id worker id. 

* @param iterations iteration count. 

et 

private native void nativeWorker(int id, int iterations); 


static { 
System.1loadLibrary ("Threads"); 


} 


除了 需要 展示 和 绑 定 用 户 接口 组 件 所 必需 的 常用 方法 之 外 ，main activity 还 提供 以 下 
主要 方法 : 


161 


Android C++ 高 级 编程 一 一 使 用 NDK 


e onNativeMessage 是 一 个 由 原生 代码 调用 的 、 用 来 向 UI 发 送 进度 消息 的 回调 函数 。 
除了 主 UI 线 程 访 问 并 处 理 UI 组 件 之 外 ,Android 不 允许 代码 在 不 同 的 线程 中 运行 。 
因为 原生 worker 函数 需要 在 不 同 的 线程 中 执行 ,onNativeMessage 方 法 通过 android . 
app.Activity 类 的 mnOnUiThread 方法 调度 UI 线程 中 的 实际 更 新 操作 。 

estartThreads 方法 将 start 请 求 发 送 到 合适 的 线程 示例 中 。 在 学 习 本 章 时 ， 会 涉及 线 
程 的 不 同 特性 ，startThreads 方法 将 便于 在 不 同 的 示例 之 间 切 换 。 

e nativeInit 方法 在 原生 代码 中 实现 。 在 执行 线程 前 完成 原生 代码 的 初始 化 。 

enativeFree 方法 在 原生 代码 中 实现 。 当 activity 销毁 时 该 方法 负责 释放 原生 资源 。 

e nativeWorker 方法 在 原生 代码 中 实现 ， 它 模拟 执行 时 间 较 长 的 任务 ， 带 有 两 个 参 
数 : worked ID 和 迭代 次 数 。 


7.1.6 生成 C/C++ 头 文件 


为 了 给 这 两 个 原生 方法 生成 函数 签名 , 首先 打开 Project Explorer, 选择 MainActivityjava 
源 文件 ， 在 项 部 菜单 栏 中 选择 Run | External Tools | Generate C and C++ Header File。javah 
工具 将 在 jni 目录 下 生成 头 文件 ， 内 容 如 程序 清单 7-4 所 示 。 


程序 清单 7-4 jni/com_apress_threads_MainActivity.h 文件 内 容 
/* 不 要 编辑 这 个 文件 - 它 是 计算 机 产生 的 */ 


#include <jni.h> 
/* 类 com apress_threads MainActivity 的 头 */ 


/* 

* Class: com apress threads MainActivity 

* Method: nativeInit 

* Signature: ()V 

i 

JNIEXPORT void JNICALL Java com apress threads MainActivity nativeInit 
(JNIEnV *, jobject); 


/* 

* Class: com apress threads MainActivity 

* Method: nativeFree 

* Signature: ()V 

Wy 

JNIEXPORT void JNICALL Java com apress threads MainActivity nativeFree 
(JUNIEnV *, jobject); 


/* 

* Class: com apress threads MainActivity 
* Method: nativeWorker 

* Signature: (II)V 

#7 
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JNIEXPORT void JNICALL Java com apress threads MainActivity nativeWorker 
(UNIEnV *, jobject, jint, jint); 


7.1.7 ”实现 原生 函数 


基于 第 7.1.6 节 生 成 的 函数 签名 ， 现 在 将 实现 原生 函数 。 

(1) 打开 Project Explorer， 右 击 jni 目录 。 

(2) 在 上 下 文 菜单 中 选择 New | Other 来 打开 New 对 话 框 。 

(3) 在 向 导 列 表 中 展开 C/C++ 类 别 。 

(4) 选择 Source File 向 导 。 

(5) 单 击 Next 按钮 。 

(6) 在 New Source File 对 话 框 中 , 将 源 文件 设置 为 com_apress_threads MainActivity.cpp。 
(7) 单 击 Finish 按钮 。 

新 建 的 源 文件 将 在 编辑 器 中 打开 ， 用 程序 清单 7-5 所 示 内 容 替 换文 件 原来 的 内 容 。 


程序 清单 7-5 jni/com_apress_threads_MainActivity.cpp 文件 的 内 容 


#include <stdio.h> 
#include <unistd.h> 


#include "com apress threads MainActivity.h" 


// 方法 ID 能 被 缓存 
static jmethodID gOnNativeMessage = NULL; 


void Java_ com aprés threads MainActivity nativeInit ( 
JNIEnv* env, 
jobject obj) 


// 如 果 方法 ID 没 被 缓存 
if (NULL == gOnNativeMessage) 
{ 

// 从 对 象 中 获取 类 


jclass clazz = env->GetObjectClass (obj); 


// 为 回调 获取 方法 ID 

gOonNativeMessage = env->GetMethodID (clazz, 
"onNativeMessage", 
"(Ljava/lang/string;)V"); 


// 如 果 方法 没有 找到 
if (NULL == gOnNativeMessage) 
{ 
// 获取 异常 类 
jclass exceptionClazz = env->FindClass( 
"java/lang/RuntimeException"); 


// 抛 出 异常 
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env->ThrowNew (exceptionClazz, "Unable to find method"); 


void Java com apress threads MainActivity nativeFree ( 
JNIEnv* env, 
jobject obj) 

{ 


} 


void Java com apress threads MainActivity nativeWorker ( 
JNIEnv* env, 
jobject obj, 
jint id, 
jint iterations) 


// 循环 给 定 的 迭代 数 
for (jint i = 0; i < iterations; i++) 
{ 

// 准备 消息 


char message[26]; 
sprintf (message, "Worker %d: Iteration %d", id, i); 


// 来 自 c 字符 串 的 消息 


jstring messageString = env->NewStringUTF (message) 


// 调用 原生 消息 方法 


env->CallVoidMethod (obj, gOnNativeMessage, messageSstring); 


// 检查 是 否 产 生 异 常 


if (NULL != env->ExceptionOccurred()) 
break; 
// 睡眠 一 秒 
sleep(1); 
} 
} 
原生 源 文件 包含 3 个 原生 函数 : 


e Java_com_apress_threads_ MainActivity_nativeInit 函数 : 通过 找 出 onNativeMessage 
函数 的 方法 ID 并 将 其 缓存 于 全 局 变量 gOnNativeMessage 中 来 初始 化 原生 代码 。 

e Java_com_apress_threads_MainActivity_nativeFree 函数 : 是 原生 资源 释放 占 位 符 
函数 ， 在 本 章 的 学 习 过 程 中 我 们 将 实现 该 函数 。 

® Java_com_apress_threads_MainActivity_nativeWorker 函数 : 用 for 循环 模拟 运 
行 时 间 较 长 的 任务 ， 它 的 循环 次 数 由 指定 的 迭代 次 数 决定 ， 迭 代 之 间 休 眠 1 秒 。 
通过 调用 onNativeMessage 方法 将 迭代 状态 传递 给 UI。 
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7.1.8 更 新 Android.mk 构建 脚本 


新 建 的 源 文件 应 该 添加 到 Android.mk 构建 脚本 以 便于 Android 构建 系统 将 它 编译 成 分 
享 库 的 一 部 分 。 打 开 Project Explorer， 展 开 jni 目录 ， 双 击 Android.mk 文件 在 编辑 器 中 打 
开 。 用 程序 清单 7-6 所 示 的 内 容 替 换文 件 内 容 。 


程序 清单 7-6 jni/Android.mk 文件 内 容 


LOCAL PATH := $(call my-dir) 


include $ (CLEAR VARS) 


LOCAL MODULE := Threads 
LOCAL SRC FILES := com apress threads MainActivity.cpp 


include $ (BUILD SHARED LIBRARY) 


示例 应 用 程序 已 经 准备 完毕 ， 现 在 可 以 在 Android 模拟 器 中 运行 它 以 验证 示例 项 目 。 


由 于 startThreads 方法 还 没 实现 ， 即 使 显示 UI， 应 用 程序 的 功能 也 不 能 实现 。 第 7.2 节 将 
多 线程 功能 添加 到 示例 应 用 程序 中 。 


7.2 Java 线程 


在 原生 代码 中 利用 多 线程 的 好 处 的 最 简单 方法 就 是 使 用 Java 线程 。 可 以 在 Java 空间 


用 纯 Java 代码 创建 java.lang.Thread 实例 ， 并 在 其 上 下 文中 调用 原生 方法 。 这 种 方法 的 主 
要 优点 是 不 要 求 原生 代码 做 任何 修改 。 


7.2.1 修改 示例 应 用 程序 使 之 能 够 使 用 Java 线程 


打开 Project Explorer， 在 编辑 器 中 打开 MainActivityjava 源 文件 ， 将 javaThreads 方法 
添加 到 MainActivity 类 中 ， 如 程序 清单 7-7 所 示 。 


程序 清单 7-7 ”将 javaThreads 方法 添加 到 MainActivity 类 
public class MainActivity extends Activity { 
J/ 
* 使 用 基于 Java 的 线程 . 


* Qparam threads thread count. 
* @param iterations iteration count. 
private void javaThreads (int threads, final int iterations) { 
// 为 每 一 个 worker 创建 一 个 基于 Java 的 线程 
for (int i = 0; i < threads; i++) { 
final int id = i; 
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Thread thread = new Thread() { 
public void run() { 
nativeWorker (id, iterations); 


} 
bs; 


thread.start (); 


} 


javaThreads 方法 有 两 个 参数 : 线程 数 和 每 个 worker 的 迭代 次 数 ， 它 完成 如 下 工作 : 

e 创建 请 求 数目 的 java.lang.Thread 对 象 

。 重 载 java.lang.Thread 类 的 run 方法 以 在 线程 上 下 文中 调用 nativeWorker 方法 。 

e 启动 每 一 个 线程 实例 。 

为 了 使 用 javaThreads 方法 ， 需 要 修改 startThreads 方法 以 指向 它 。 学 习 本 章 时 , 我 们 
要 为 其 他 示例 重复 同样 的 步 又， 这样 就 可 以 轻松 地 在 示例 之 问 转换。 按照 程 序 清单 7-8 所 
示 更 新 startThreads 方法 。 


程序 清单 7-8 ”修改 后 的 startThreads 方法 调用 javaThreads 方法 
public class MainActivity extends Activity { 
* 启动 给 定数 量 的 线程 迭代 . 


* Q@param threads thread count . 

* @param iterations iteration count. 

i 

private void startThreads (int threads, int iterations) { 
javaThreads (threads, iterations); 

} 

} 
7.2.2 执行 Java Threads 示例 


在 Android 模拟 器 中 运行 示例 应 用 程序 ， 步 骤 如 下 : 

(1) 将 线程 数 设置 为 2， 使 两 个 线程 并 发 运行 。 

(2) 将 迭代 次 数 设置 为 10， 使 每 个 线程 迭代 10 个 步骤 。 

(3) 单 击 Start Threads 按钮 启动 Java 线程 。 

javaThreads 方法 将 创建 两 个 线程 ， 每 个 线程 将 用 10 个 迭代 运行 nativeWorker 函数 ， 
线程 将 运行 10 秒 。 开 始 每 一 个 迭代 步骤 时 ，nativeWorker 函数 将 通过 发 送 一 个 更 新 信息 来 
通知 UI， 如 图 7-5 所 示 。 
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orker 0: lteration 0 
orker 1: lteration 0 
orker 0: lteration 1 
orker 1: lteration 1 
orker 0: lteration 2 
orker 1: lteration 2 
orker 0: lteration 3 
orker 1: lteration 3 


图 7-5 原生 代码 在 Java 多 线程 中 运行 


注意 : 


如 果 屏 幕 过 小 ， 你 可 能 需要 滚动 结果 来 看 最 新 的 更 新 消息 。 
7.2.3 ”原生 代码 使 用 Java 线程 的 优 缺 点 


与 使 用 原生 线程 相 比 ， 原 生 代码 使 用 Java 线程 有 如 下 优点 : 

e 更 容易 建立 。 

e 原生 代码 不 要 求 做 任何 修改 。 

e 因为 Java 线程 已 经 是 Java 平台 的 一 部 分 ， 所 以 不 要 求 显 式 地 附着 到 虚拟 机 上 。 原 
生 代码 可 以 用 提供 的 线程 专用 JNIEnv 接口 指针 与 Java 代码 通信 。 

。 通过 java.lang.Thread 类 提供 的 方法 可 以 用 于 与 Java 代码 中 的 线程 实例 无 缝 交互。 

虽然 有 上 述 优 点 ， 但 是 在 用 于 多 线程 原生 代码 时 ， 与 使 用 原生 线程 相 比 原生 代码 使 用 

Java 线程 有 如 下 不 足 : 

e 因为 原生 空间 中 没有 创建 Java 线程 的 APL 所 以 假设 为 线程 分 配 任 务 的 逻辑 是 Java 
代码 的 一 部 分 。 

e 因为 基于 Java 的 线程 对 原生 代码 是 透明 的 ， 所 以 假定 原生 代码 是 线程 安全 的 。 

e 原生 代码 不 能 获 益 于 其 他 并 发 程序 的 概念 或 组 件 ， 例 如 信号 量 等 ， 因 为 原生 空间 
中 没有 可 供 Java 线程 使 用 的 相应 API。 

。 在 不 同 的 线程 中 运行 的 原生 代码 不 能 通信 或 直接 共享 资源 。 


注意 : 
尽管 Java 线程 中 的 一 些 缺点 可 以 通过 使 用 JNI 来 调用 必要 的 Java API 来 解决 , 但 由 于 
通过 JNI 边界 是 个 非常 复杂 的 操作 ， 所 以 不 提倡 使 用 这 个 方法 。 


第 7.3 节 开 始 学 习 原 生 线 程 。 
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7.3 ”POSIX 线程 


POSIX 线程 也 被 简称 为 Pthreads， 是 一 个 线程 的 POSIX 标准 。1995 年 之 前 ， 有 一 些 不 
同 的 线程 API 存在 。1995 年 发 布 了 POSIX.1c、 线 程 扩展 和 标准 ， 并 且 为 创建 和 处 理 线程 
定义 了 一 个 通用 的 API。 许 多 主流 操作 系统 ， 包 括 Microsoft Windows、Mac OS X、BSD 
和 Linux 提供 满足 POSIX 线程 标准 的 多 线程 支持 .因为 Android 是 基于 Linux 操作 系统 的 ， 
所 以 它 为 原生 代码 提供 不 一 致 的 POSIX 线程 实现 。 由 于 POSIX 标准 非常 庞大 ， 本 节 只 介 
绍 Android 平台 完全 支持 的 API。 


7.3.1 在 原生 代码 中 使 用 POSIX 线程 


通过 pthread.h 头 文件 声明 POSIX Thread APIs, 为 了 在 原生 代码 中 使 用 POSIX Thread， 
需要 先 包含 这 个 头 文件 。 


#include <pthread.h> 


POSIX Thread 的 Android 实现 是 Bionic 标准 C 标准 库 的 一 部 分 。 与 其 他 平台 不 同 , 在 
编译 时 不 需要 链接 任何 其 他 的 库 。 


7.3.2 用 pthread_create 创建 线程 


通过 pthread_create 函数 创建 POSIX 线程 。 


int pthread create (pthread t* thread, 
pthread attr t const* attr, 
void* (*start routine) (void*), 
void* arg); 

该 函数 有 如 下 参数 : 

。 指向 thread_t 类 型 变量 的 指针 ， 函 数 用 该 指针 返回 新 线程 的 句柄 。 

。 指向 pthread_attr t 结构 的 指针 形式 存在 的 新 线程 属性 ， 可 以 通过 该 属性 指定 新 线 
程 的 栈 基 址 、 栈 大 小 、 守 护 大 小 、 调 度 策略 和 调度 优先 级 等 。 本 章 后 面 的 内 容 将 
介绍 这 些 属 性 中 的 一 部 分 ， 如 果 使 用 默认 值 ， 取 值 可 能 为 NULL。 

e 指向 线程 启动 程序 的 函数 指针 ， 启 动 程序 函数 签名 格式 如 下 : 


void* start rountine (void* args) 


启动 程序 将 线程 参数 看 成 void 指针 ， 返 回 void 指针 类 型 结果 。 

当 线 程 以 空 指针 的 形式 执行 时 , 参数 都 需要 被 传递 给 启动 程序 , 如 果 不 需 要 传递 参数 ， 
它 可 以 为 NULL。 

成 功 时 ，pthread_create 函数 返回 0， 否则 返回 一 个 错误 代码 。 
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7.3.3 ”更 新 示例 应 用 程序 以 使 用 POSIX 线程 


现在 可 以 扩展 示例 应 用 程序 以 使 用 POSIX 线程 来 测试 pthread_create 函数 。 
1. 更 新 Main Activity 


打开 Project Explorer， 在 编辑 器 中 打开 MainActivityjava 源 文 件 。 将 原生 posixThreads 
方法 添加 到 MainActivity 类 中 ， 如 程序 清单 7-9 所 示 。 
程序 清单 7-9 ”将 原生 posixThreads 方法 添加 到 MainActivity 类 
public class MainActivity extends Activity { 
2 
* 使 用 POSIX 线程 . 


* @param threads thread count. 
* @param iterations iteration count. 


private native void posixThreads (int threads, int iterations); 


} 


和 javaThreads 方法 相似 ，posixThreads 方法 也 有 两 个 参数 : 线程 数 和 每 个 worker 的 迭 
代 次 数 , 为 了 使 用 posixThreads 方 法 ,需要 修改 startThreads 方 法 ,让 该 方法 指向 posixThreads 
方法 而 不 是 javaThreads 方法 ， 按 照 程序 清单 7-10 更 新 startThreads 方法 。 


程序 清单 7-10 ”修改 startThreads 方法 调用 posixThreads 方法 
public class MainActivity extends Activity { 
/太太 
* 启动 给 定数 量 的 线程 进行 迭代 . 


* @param threads thread count. 
* @param iterations iteration count. 


A 
private void startThreads (int threads, int iterations) { 
posixThreads (threads, iterations); 
} 
} 
2. 为 posixThreads 方法 重新 生成 C/C++ 头 文件 


如 果 要 使 用 POSIX 线程 ， 将 会 在 原生 代码 而 不 是 Java 代码 中 实现 posixThreads 方法 。 
在 修改 MainActivity 类 时 , 应 该 更 新 com_apress_threads_MainActivity.h 头 文件 .打开 Project 
Explorer 选择 MainActivityjava 源 文件 ,在 顶部 菜单 栏 中 选择 Run | External Tools | Generate 
C and C++Header File。 更 新 的 头 文件 将 包含 posixThreads 原生 方法 的 函数 声明 ， 如 程序 清 
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单 7-11 所 示 。 


程序 清单 7-11 为 posixThreads 生成 函数 签名 


/* 

* Class: com apress threads MainActivity 
* Method: posixThreads 

* Signature: (II)V 

We 


JNIEXPORT void JNICALL Java com apress threads MainActivity posixThreads 
(JNIEnv *, jobject, jint, jint); 


3. 更 新 原生 代码 


现在 要 更 新 POSIX 线程 的 原生 代码 。 由 于 POSIX 线程 不 是 Java 平台 的 一 部 分 ， 为 了 
实现 同样 的 功能 需要 在 原生 代码 中 做 许多 修改 。 打 开 Project Explore， 展 开 jni 目录 ， 并 双 
击 打开 com_apress_threads_MainActivity.cpp 源 文件 。 然 后 按照 以 下 步骤 操作 : 


(1) 为 了 在 原生 代码 中 使 用 POSIX Thread API, 需要 在 源 文件 中 包括 pthread.h 头 文件 ， 
如 程序 清单 7-12 所 示 。 


程序 清单 7-12 为 POSIX Thread 包括 pthread.h 头 文件 


#include <stdio.h> 
#include <unistd.h> 


#include <pthread.h> 


#include "com apress threads MainActivity.h" 


(2) 如 前 所 述 ， 在 运行 一 个 新 线程 时 ，pthread_create 函数 能 传递 一 个 空 指针 参数 给 启 
动 程序 。com_apress_threads_nativeWorker 函数 需要 提供 两 个 任务 特定 参数 ，worker ID 和 
迭代 次 数 。 为 了 给 启动 程序 传递 多 个 参数 ， 需 要 一 个 新 的 结构 体 将 这 些 参 数 封装 起 来 。 添 
加 NativeWorkerArgs 结构 体 定义 ， 如 程序 清单 7-13 所 示 。 


程序 清单 7-13 ”定义 NativeWorkerArgs 结构 体 
#include "com apress threads MainActivity.h" 


// 原生 worker 线程 参数 
struct NativeWorkerArgs 
{ 

jint id; 

jint iterations; 
}; 


// 能 被 缓存 的 方法 ID 


static jmethodID gOnNativeMessage = NULL; 
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(3) 由 于 POSIX 线程 不 是 Java 平台 的 一 部 分 ,因此 虚拟 机 不 能 识别 它们 。 为 了 和 Java 
空间 交互 ，POSIX 线程 应 该 先 将 自己 附着 到 虚拟 机 上 。 为 了 使 POSIX 线程 正确 地 附着 到 
虚拟 机 上 ，Java 虚拟 机 接口 应 该 为 POSIX 线程 所 用 。 一旦 它们 附着 到 虚拟 机 上 , 在 POSIX 
线程 上 运行 的 worker 代码 需要 调用 onNativeMessage callback 方法 来 通知 UI。 这 需要 有 一 
个 指向 MainActivity 类 的 引用 。 因 为 是 一 个 原生 引用 ， 因 此 JNI 方法 调用 提供 的 对 象 引 用 
不 能 缓存 。 应 该 创建 并 存储 一 个 全 局 引用 供 线程 使 用 。 如 程序 清单 7-14 所 示 添 加 两 个 全 局 
变量 到 原生 代码 。 


程序 清单 7-14 ”全 局 变量 保存 Java VM 接口 指针 和 对 象 实例 的 全 局 引用 


// 能 被 缓存 的 方法 ID 
static jmethodID gOnNativeMessage = NULL; 


// uava 虚拟 机 接口 指针 
static JavaVMx gVm = NULL; 


// 对 象 的 全 局 引用 
static jobject gobj = NULL; 


void Java com apress threads MainActivity nativeInit ( 
JNIEnv* env, 
jobject obj) 

(4) 有 许多 方法 可 以 在 原生 代码 中 获得 Java 虚拟 机 接口 指针 ， 最 简单 、 正 确 的 方式 是 
通过 JNI OnLoad 函数 。 当 共享 库 开始 加 载 时 虚拟 机 自动 调用 该 函数 。 该 函数 将 Java 虚拟 
机 接口 指针 作为 它 的 一 个 参数 。 如 程序 清单 7-15 所 示 ， 为 了 将 Java 虚拟 机 接口 指针 存储 
到 前 面 步骤 中 定义 的 gVm 全 局 变量 中 ， 需 要 在 原生 代码 中 添加 JNL OnLoad 函数 。 


程序 清单 7-15 JNI OnLoad 函数 存储 Java 虚拟 机 接口 指针 


jint JNI_OnLoad (JavaVM* vm, void* reserved) 
{ 
// 缓存 Java 虚拟 机 接口 指针 


gVm = vm; 
return JNI VERSION 1 4; 

} 

(5) 为 了 调用 onNativeMessage 回调 方法 将 更 新 内 容 从 原生 代码 传递 到 UI， 需 要 用 到 
MainActivity 类 实例 的 对 象 引用 。 如 程序 清单 7-16 所 示 ， 更 新 Java_com apress_threads_ 
MainActivity_nativeInit 方法 创建 一 个 线程 可 用 的 全 局 引用 。 

程序 清单 7-16 ”为 对 象 实例 创建 一 个 全 局 引用 


void Java com apress threads MainActivity nativeInit ( 
JNIEnVv* env, 
jobject obj) 
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// 如 果 对 象 的 全 局 引用 未 设置 
if (NULL == gObj) 
{ 
// 为 对 象 创建 一 个 新 的 全 局 引用 
gobj = env->NewGlobalRef (obj); 


if (NULL == gObj) 
六 
goto exit; 
} 
} 


// 如 果 方 法 ID 未 缓存 
if (NULL == gOnNativeMessage) 


exit: 
return; 


} 


(6) 当 不 再 使 用 时 ， 需 要 正确 地 删除 全 局 引用 : 和 否则 会 发 生 内 存 泄露 。 一 旦 activity 停 
止 ， 按 照 程 序 清 单 7-17 所 示 更 新 Java_com_apress_threads MainActivity_nativeFree 函数 以 
删除 全 局 引用 。 


程序 清单 7-17 更 新 nativeFree 方法 删除 全 局 引用 


void Java_com_apress_threads_MainRctivity nativeFree ( 
JNIENnVv* env, 
jobject obj) 


// 如 果 对 象 的 全 局 引用 未 设置 
if (NULL != gobj) 


// 删除 全 局 引用 
env->DeleteGlobalRef (gObj); 
gobj = NULL; 


(7) 为 了 在 POSIX 线程 中 运行 Java_com _apress_threads_MainActivity_nativeWorker 函 
数 ， 需 要 一 个 中 间 启 动 程序 将 POSIX 线程 正确 地 附着 到 Java 虚拟 机 上 ， 以 获得 一 个 有 效 
的 JNIEnv 接口 指针 ， 用 适当 的 一 组 参数 执行 原生 worker。 如 程序 清单 7-18 所 示 ， 添 加 
nativeWorkerThread 启动 程序 。 


程序 清单 7-18 ”为 原生 Worker 线程 添加 启动 程序 
static void* nativeWorkerThread (void* args) 
{ 


JNIEnv* env = NULL; 
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// 将 当前 线程 附加 到 Java 虚拟 机 上 
// 并 且 获得 JNIEnv 接口 指针 
if (0 == gVm->AttachCurrentThread(&env, NULL)) 
‘ 
// 获取 原生 worker 线程 参数 


NativeWorkerArgs* nativeWorkerArgs = (NativeWorkerArgs*) args; 


// 在 线程 上 下 文中 运行 原生 worker 

Java com apress threads MainActivity nativeWorker (env, 
gobj, 
nativeWorkerArgs->id, 
nativeWorkerArgs->iterations); 


// 释放 原生 worker 线程 参数 


delete nativeWorkerArgs; 


// 从 Java 虚拟 机 中 分 离 当 前 线程 
gVm->DetachCurrentThread () 7 


} 


return (void*) 1; 


} 


(8) 由 于 所 有 的 准备 工作 均 已 就 绪 , Java_com _apress_threads MainActivity_posixThreads 
函数 可 以 在 原生 代码 中 实现 。 函数 将 用 pthread_create 函数 创建 新 的 线程 并 提供 封装 在 之 
前 定义 的 NativeWorkerArgs 结构 体 中 的 worker 参数 。 出 错时 函数 会 抛 出 一 个 java.lang. 
RuntimeException 并 终止 。 如 程序 清单 7-19 所 示 ， 添 加 函数 到 原生 代码 。 


程序 清单 7-19 ”posixThreads 原生 方法 的 实现 


void Java_ com apress threads MainActivity posixThreads ( 
JNIEnv* env, 
jobject obj, 
jint threads, 
jint iterations) 


// 为 每 一 个 worker 创建 一 个 POSIX 线程 
for (jint i = 0; i < threads; i++) 
浊 
// 原生 worker 线程 参数 
NativeWorkerArgs* nativeWorkerArgs = new NativeWorkerArgs(); 
nativeWorkerArgs->id = i; 
nativeWorkerArgs->iterations = iterations; 


// 线程 句柄 

pthread t thread; 

// 创建 一 个 新 线程 

int result = pthread createl( 
&thread, 
NULL， 
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nativeWorkerThread, 
(void*) nativeWorkerArgs); 


if (0 != result) 
{ 
// 获取 异常 类 
jclass exceptionClazz = env->FindClass( 
"java/lang/RuntimeException"); 


// 抛 出 异常 


env->ThrowNew (exceptionClazz, "Unable to create thread"); 


时 
现在 POSIX 线程 被 集成 到 原生 代码 中 。 


7.3.4 执行 POSIX 线程 示例 


在 Android 模拟 器 上 运行 示例 应 用 程序 ， 步 骤 与 为 Java 线程 提供 的 、 用 POSIX 线程 
测试 应 用 程序 的 步骤 相同 。 尽 管 底层 线程 机 制 是 不 同 的 , 但 应 用 程序 的 执行 过 程 是 一 样 的 。 


7.4 从 POSIX 线程 返回 结果 


当 线 程 终止 时 ， 能 返回 一 个 结果 。 这 是 通过 线程 启动 程序 返回 的 空 指针 实现 。 在 前 面 
的 例子 中 , Java_com_apress_threads_MainActivity_posixThreads 函数 被 设计 成 在 线程 执行 后 
立即 返回 。 可 以 将 该 函数 修改 成 等 待 线程 结束 后 再 返回 。 通 过 pthread join 函数 可 以 使 一 
个 函数 等 待 线程 终止。 


int pthread join (Pthread t thread, void** ret val); 


pthread_join 函数 带 有 下 列 参数 : 

e 线程 句柄 ， 它 是 pthread_create 函数 返回 的 目标 线程 。 

e 指向 空 指针 的 指针 ， 该 指针 是 为 了 从 启动 程序 中 获得 返回 值 。 

它 将 挂 起 调用 线程 的 执行 ， 直到 目标 线程 终止 。 如 果 ret_val 不 是 NULL, 该 函数 将 ret 
val 指针 的 值 设置 为 启动 程序 的 返回 结果 。 如 果 成 功 ，pthread join 函数 返回 值 是 0， 否 则 
它 将 返回 错误 代码 。 


更 新 原生 代码 以 使 用 pthread_join 


为 了 在 Activity 中 看 到 pthread_join， 和 需要 更 新 示例 应 用 程序 。 打 开 Project Explorer， 
展开 jni 目录 ， 双 击 com_apress_threads MainActivity.cpp 源 文件 在 编辑 器 中 打开 它 。 如 程 
序 清单 7-20 所 示 更 新 Java_com apress_threads_MainActivity_posixThreads 函数 。 
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程序 清单 7-20 将 pthread_ join 添加 到 原生 代码 


void Java com apress threads MainActivity posixThreads ( 
JNIEnv* env, 
jobject obj, 
jint threads, 
jint iterations) 


// 线程 句柄 
Pthread t* handles = new pthread t[threads]; 


// 为 每 个 worker 创建 一 个 POSIX 线程 
for (jint i = 0; i < threads; i++) 
{ 
// 原生 worker 线程 参数 
NativeWorkerArgs* nativeWorkerArgs = new NativeWorkerArgs(); 
nativeWorkerArgs->id = i; 
nativeWorkerArgs->iterations = iterations; 


// 创建 新 线程 
int result = pthread createl( 
ghandles [i], 
NULL, 
nativeWorkerThread, 
(void*) nativeWorkerArgs); 


if (0 != result) 
{ 
// 获取 异常 类 
jclass exceptionClazz = env->FindCclass( 
"java/lang/RuntimeException"); 


// 抛 出 异常 
env->ThrowNew (exceptionClazz, "Unable to create thread"); 
goto exit; 


} 


// 等 待 线程 终止 
for (jint i = 0; i < threads; i++) 
{ 

Void* result = NULL; 


// 连接 每 个 线程 句柄 
if (0 != pthread join(handles[i], gresult)) 


《 
// 获 取 异 常 类 


jclass exceptionClazz = env->FindClass( 
"java/lang/RuntimeException"); 
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// 抛 出 异常 


env->ThrowNew (exceptionClazz, "Unable to join thread") 
} 


else 
{ 
// 准备 message 
char message[26]; 
sprintf (message, "Worker %d returned %d", i, result); 


// 来 自 c 字 符 串 的 Message 
jstring messageString = env->NewStringUTF (message); 


// 调用 原生 消息 方法 
env->CallVoidMethod (obj, gonNativeMessage, messageString); 


// 检查 是 否 产生 异常 
if (NULL != env->ExceptionOccurred()) 
{ 
goto exit; 
} 


} 


exit: 
return; 
} 
在 Android 模拟 器 上 运行 示例 应 用 程序 要 做 必要 的 改变 。 将 线程 数 和 人 迭代 次 数 设 置 为 
-个 较 小 的 数字 ， 比 如 2， 并 单 击 Start Threads 按钮 ， 你 会 立即 发 现 UI 将 挂 起 几 秒 。 这 是 
由 于 pthread join 函数 将 UI 的 主线 程 挂 起 直到 创建 的 线程 终止 .UI 将 显示 线程 的 返回 结果 。 


7.5 ”POSIX 线程 同步 


由 于 运行 在 相同 的 进程 室 间 ， 线 程 共享 相同 的 内 存 和 资源 。 这 使 线程 彼此 通信 和 共享 
数据 变 得 容易 ， 但 是 有 可 能 产生 两 种 错误 :由 于 并 发 修改 共享 资源 产生 线程 干扰 和 内 存 不 
一 致 性 ， 此 时 线程 同步 变 得 至 关 重 要 。 线 程 同步 机 制 确保 两 个 并 发 运行 的 线程 不 同时 执行 
代码 的 特定 部 分 .和 Java 线程 相似 ,POSIX 线程 API 也 提供 同步 功能 .本章 主要 学 习 POSIX 
线程 提供 的 两 个 最 常用 的 同步 机 制 : 

。 互 斥 锁 (Mutexes) 确 保 代码 的 互 斥 执行 ， 即 代码 的 特定 部 分 不 同时 执行 。 

e 信号 量 (Semaphores) 控 制 对 特定 数目 可 用 资源 的 访问 ， 如 果 没 有 可 用 资源 ， 调 用 线 

只 是 在 信号 量 所 涉及 的 资源 上 等 待 ， 直 到 资源 可 用 。 


7.5.1 用 互 斥 锁 同 步 POSIX 线程 


POSIX 线程 API 通过 pthread_ mnutex _t 数据 类 型 展示 互 斥 锁 到 原生 代码 。POSIX 线程 
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API 从 原生 代码 提供 一 组 交互 功能 的 互 斥 。 使 用 前 ， 互 斥 变 量 应 该 先 被 初始 化 。 
1. 初始 化 互 斥 锁 


POSIX 线程 API 提供 两 种 初始 化 互 斥 锁 的 方法 : pthread_mutex_init 函数 和 PTHREAD 
MUTEX INITIALIZER 宏 。pthread mutex_init 函数 将 被 用 来 初始 化 互 斥 锁 。 


int pthread mutex init(pthread mutex t* mutex,const pthread mutexattr t* 
attr); 


pthread_mutex_init 函数 有 两 个 参数 ， 一 个 指向 要 初始 化 的 互 斥 变量 的 指针 和 一 个 指向 
为 互 斥 锁定 义 属性 的 pthread_mutextattr t 结构 体 的 指针 。 如 果 第 二 个 参数 设置 为 NULL， 
将 使 用 默认 属性 。 如 果 默 认 属 性 够 用 ，PTHREAD MUTEX INITIALIZER 宏 比 pthread_ mnutex 
_init 函数 更 合适 。 


pthread mutex t mutex = PTHREAD MUTEX INITIALIZER; 


如 果 初 始 化 成 功 ， 互 斥 锁 被 初始 化 并 处 于 锁 打 开 的 状态 ， 函 数 返 回 0， 否 则 返回 错误 
代码 。 


2. 锁定 互 斥 锁 


pthread_mutex_lock 函数 可 以 通过 对 一 个 已 经 初始 化 的 互 斥 锁 进行 封锁 操作 达到 互 
斥 操 作 的 目的 。 


int pthread mutex lock(pthread mutex t* mutex); 


该 函数 带 有 一 个 指向 互 斥 锁 变量 的 指针 。 如 果 互 斥 锁 已 经 被 锁 上 ， 调 用 线程 被 挂 起 直 
到 互 斥 锁 被 打开 。 如 果 成 功 ， 函 数 返 回 0， 否 则 返回 错误 代码 。 


3. 解锁 互 斥 锁 
在 临界 区 代码 执行 完成 时 ， 可 使 用 pthread_mutex_unlock 函数 解锁 互 斥 锁 。 
int pthread mutex unlock(pthread mutex t* mutex); 


该 函数 带 有 一 个 指向 要 解锁 的 互 斥 锁 变量 指针 。 调 度 策略 决定 解锁 后 执行 哪个 等 待 互 
斥 锁 的 线程 。 如 果 成 功 ， 函 数 返 回 0， 否 则 返回 错误 代码 。 


4. 销毁 互 斥 锁 


- 旦 不 再 需要 互 斥 锁 ， 可 以 用 pthread_mutex_destroy 函数 销毁 互 斥 锁 。 该 函数 带 有 一 
个 指向 要 销毁 的 互 斥 锁 变 量 的 指针 ， 试 图 销毁 一 个 锁 着 的 变量 将 返回 不 确定 结果 。 


int pthread mutex destroy (pthread mutex t* mutex); 
5. 修改 示例 应 用 程序 以 使 用 互 斥 锁 


现在 ， 修 改 原 生 代 码 以 便于 实验 互 斥 锁 。 在 Project Explorer 中 展开 jni 目录 ， 双 击 打 
开 com_apress_threads_ MainActivity.cpp 源 文件 ， 按 以 下 步骤 操作 : 


A 
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(1) 如 程序 清单 7-21 所 示 将 互 斥 锁 变 量 添加 到 原生 代码 中 。 


程序 清单 7-21 添加 互 斥 锁 到 原生 代码 
// 对 象 的 全 局 引用 


static jobject gobj = NULL; 


// 互 斥 实例 
static pthread mutex t mutex; 


jint JNI OnLoad (JavaVM* vm, void* reserved) 


(2) 使 用 之 前 先 初始 化 互 斥 锁 变 量 。 如 程序 清单 7-22 所 示 ， 更 新 Java_com apress_ 
threads MainActivity_nativeInit 函数 以 初始 化 互 斥 锁 。 


程序 清单 7-22 ”初始 化 互 斥 锁 变量 


void Java com apress threads MainActivity nativeInit ( 
JNIEnVv* env, 
jobject obj) 


// 初始 化 互 斥 
if (0 != pthread mutex init(gmutex, NULL)) 
{ 
// 获取 异常 类 
jclass exceptionClazz = env->FindClass( 
"java/lang/RuntimeException"); 


// 抛 出 异常 


env->ThrowNew (exceptionClazz, "Unable to initialize mutex"); 
goto exit; 


} 


(3) 一 旦 不 再 需要 互 斥 锁 , 应 该 将 它 销毁 。 如 程序 清单 7-23 所 示 更 新 Java_com _apress_ 
threads_MainActivity_nativeFree 函数 。 


程序 清单 7-23 ”销毁 互 斥 锁 变量 


void Java_com_apress_threads_MainRctivVity nativeFree ( 
JUNIEnVx env, 
jobject obj) 


// 销 虎 互 扩 锁 
if (0 != pthread mutex destroy (gmutex)) 
{ 

// 获取 异常 类 


jclass exceptionClazz = env->FindClass( 
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"java/lang/RuntimeException"); 


// 抛 出 异常 


env->ThrowNew (exceptionClazz, "Unable to destroy mutex"); 


} 


(4) worker 线程 可 以 在 代码 开始 部 分 锁定 互 斥 锁 并 在 代码 终止 部 分 解锁 。 如 程序 清 
单 7-24 所 示 ， 更 新 Java_com apress_threads MainActivity_nativeWorker 函数 。 


程序 清单 7-24 ”锁定 和 解锁 互 斥 锁 


void Java com apress threads MainActivity nativeWorker ( 
JNIEnv* env, 
jobject obj, 
jint id, 
jint iterations) 


// 锁定 互 斥 锁 
if (0 != pthread mutex lock (gmutex)) 
{ 
// 获取 异常 类 
jclass exceptionClazz = env->FindClass( 
"java/lang/RuntimeException"); 


// 抛 出 异常 
env->ThrowNew (exceptionClazz, "Unable to lock mutex"); 
goto exit; 


// 解锁 互 斥 锁 
if (0 != pthread mutex unlock (gmutex)) 
{ 
// 获取 异常 类 
jclass exceptionClazz = env->FindCclass( 
"java/lang/RuntimeException"); 


// 抛 出 异常 
env->ThrowNew (exceptionClazz, "Unable to unlock mutex"); 
} 


exit: 
return; 
} 
可 以 在 Android 模拟 器 上 运行 示例 应 用 程序 。 由 于 原生 代码 正在 使 用 互 斥 锁 ， 线 程 将 
不 会 同时 执行 。 只 有 有 互 斥 锁 的 线程 会 被 执行 并 向 UI 发 送 更 新 信息 ; 其 他 线程 将 被 挂 起 
等 待 互 斥 锁 可 用 。 
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7.5.2 ”使 用 信号 量 同 步 POSIX 线程 


和 其 他 POSIX 函数 不 同 ，POSIX 信和 号 量 在 不 同 的 头 文件 semaphore.h. 中 声明 。 
#include <semaphore.h> 


原生 代码 中 看 到 的 POSIX 信号 量 是 sem t 类 型 的 。POSIX Semaphore API 提供 了 一 组 
与 原生 代码 中 的 信号 量 交互 的 函数 。 在 使 用 之 前 ， 信 号 量变 量 应 该 先 被 初始 化 。 


1. 初始 化 信号 量 
POSIX Semaphore API 提供 了 sem _init 函数 来 初始 化 信号 量变 量 。 
extern int sem init(sem t* sem, int pshared, unsigned int value); 


它 有 三 个 参数 : 一 个 将 被 初始 化 的 信号 量变 量 指针 、 共 享 标志 (flag) 及 其 初始 值 。 如 果 
成 功 ， 函 数 返 回 0， 否 则 返回 -1。 


2. 锁定 信号 量 
- 旦 信号 量 被 正确 地 初始 化 了 ， 线 程 可 以 使 用 sem_wait 函数 减少 信号 量 的 数量 。 


extern int sem wait (Sem t* Sem) 7 


这 个 函数 有 一 个 信号 量变 量 指针 。 如 果 信 号 量 的 值 大 于 零 ， 上 锁 成 功 ， 并 且 信 号 量 的 
值 也 会 相应 递减 。 如 果 信 号 量 的 值 是 零 ， 调 用 线程 被 挂 起 ， 直 到 另 一 个 线程 通过 解锁 它 增 
加 了 信号 量 的 值 。 如 果 成 功 ， 函 数 返 回 0， 否 则 返回 -1。 


3. 解锁 信号 量 
在 临界 区 代码 执行 完成 时 ， 线 程 可 以 使 用 sem_post 函数 解锁 信号 量 。 
extern int sem post(sem t* Sem) 7 


当 使 用 sem_post 函数 解锁 信号 量 以 后 ， 信 号 量 的 值 会 增加 1。 调 度 策略 决定 信号 量 解 
锁 后 执行 哪个 等 竺 线程。 如果 成 功 ， 函 数 返 回 0， 否 则 返回 -1。 


4. 销毁 信号 量 
一 旦 不 再 需要 信号 量 ， 可 以 通过 sem_destroy 函数 销毁 它 。 
extern int sem destroyl(sem t* sem); 


该 函数 有 一 个 将 被 销毁 的 信号 量变 量 指针 。 销 毁 一 个 另 一 个 线程 正在 阻塞 的 信号 量 有 
可 能 导致 未 知行 为 。 如 果 成 功 ， 函 数 返 回 0， 否 则 返回 -1。 


7.6 ”POSIX 线程 的 优先 级 和 调度 策略 


采用 优先 级 调度 的 线程 调度 策略 是 按照 某 种 执行 顺序 对 线程 进行 排序 ， 本 节 简 要 介绍 
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调度 策略 和 线程 优先 级 。 
7.6.1 POSIX 的 线程 调度 策略 


POSIX 线程 规范 要 求实 现 一 组 调度 策略 。 最 经 常 使 用 的 调度 策略 如 下 : 
e SCHED FIFO: 先进 先 出 调度 策略 基于 线程 进入 列表 的 时 间 对 线程 进行 排序 , 也 可 
以 基于 优先 级 在 列表 中 移动 线程 。 
e SCHED RR: 循环 轮转 调度 策略 是 线程 执行 时 间 加 以 限制 的 SCHED FIFO, 其 目 
的 是 避免 线程 独占 可 用 的 CPU 时 间 。 
这 些 调 度 策略 常量 在 sched.h 头 文件 中 定义 。 可 以 在 用 pthread_create 函数 创建 一 个 新 
线程 时 ， 用 线程 属性 结构 pthread_attr_t 的 sched_policy 域 来 定义 调度 策略 ， 也 可 以 在 运行 
时 用 pthread_setschedparam 函数 定义 调度 策略 。 


int pthread setschedparam(pthread t thid, int poilcy, 
struct sched param const* Param) 7 


该 函数 的 参数 是 一 个 指向 目标 线程 句柄 的 指针 ， 调 度 策略 及 调度 策略 所 需要 的 参数 。 
7.6.2 POSIX Thread 优先 级 


POSIX Thread API 也 提供 基于 调度 策略 调整 线程 优先 级 的 函数 。 可 以 在 用 pthread_create 
函数 创建 一 个 新 线程 时 , 用 线程 属性 结构 pthread_attr t 的 sched_priority 域 来 定义 调度 优先 
级 ; 也 可 以 在 运行 时 用 pthread_setschedparam 函数 在 sched_param 结构 体 中 提供 优先 级 。 
优先 级 的 最 大 值 和 最 小 值 的 取 值 取决 于 所 使 用 的 调度 策略 ， 应 用 程序 可 以 使 用 
sched_get_priority_max 函数 and sched_get_priority_min 函数 查询 这 些 数 。 


7.7 小 结 
本 章 学 习 了 通过 Java 线程 和 POSIX 线程 的 原生 空间 提供 的 可 能 的 多 线程 机 制 。 本 章 


对 这 些 线程 机 制 进行 了 比较 ， 重 点 阐述 了 POSIX 线程 以 便于 对 原生 空间 提供 的 线程 APIs 
进行 快速 概述 ， 如 与 POSIX 线程 相关 的 同步 、 优 先 级 和 调度 等 。 
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POSIX Socket API: 
面向 连接 的 通信 


因为 原生 代码 应 用 在 一 个 远离 用 户 的 孤立 环境 中 执行 ， 所 以 它们 需要 一 个 与 父 应 用 或 
外 界 进行 通信 的 媒介 以 提供 服务 .第 3 章 学 习 了 让 原生 代码 与 其 父 Java 应 用 进行 通信 的 JNI 
技术 。 从 本 章 开始 ， 我 们 将 深入 探讨 在 Bionic 中 可 用 的 POSIX Socket API， 它 们 可 以 使 原 
生 代 码 与 外 界 直接 通信 而 不 必 调 用 Java 层 。 

socket 是 一 个 连接 的 终点 ， 它 可 以 被 命名 和 寻 址 以 在 相同 机 器 或 网 络 中 不 同 机 器 上 的 
应 用 程序 之 间 传输 数据 。POSIX Socket API 以 前 被 称 为 Berkeley Socket API， 是 一 个 高 度 
通用 的 设计 ， 它 使 应 用 能 通过 同一 组 API 函数 在 各 种 协议 族 上 进行 通信 。 

本 章 将 简要 介绍 面向 连接 的 通信 POSIX Socket API， 并 重点 讨论 以 下 与 Android 平台 
有 关 的 问题 。 

e POSIX sockets 概述 

e sockets 族 

e 面向 连接 的 sockets 

在 详细 介绍 面向 连接 的 通信 POSIX Socket API 之 前 ， 先 创建 一 个 名 为 Echo 的 简单 示 
例 应 用 。 该 示例 应 用 将 作为 一 个 测试 平台 ， 使 我 们 在 学 习 本 章 及 其 后 两 章 的 内 容 时 能 从 不 
同 角度 更 好 地 理解 socket 编程 。 


8.1 Echo Socket 示例 应 用 


该 示例 应 用 将 提供 以 下 内 容 : 
e 一 个 用 来 定义 配置 socket 所 需 参数 的 简单 用 户 界面 。 
。 进行 简单 回 显 服务 的 服务 逻辑 ， 该 服务 将 接收 到 的 字 节 重复 返回 给 发 送 者 。 
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样板 原生 代码 片段 ， 方 便 进行 原生 层 的 Android socket 编程 。 
一 个 面向 连接 的 socket 通信 示例 。 

一 个 无 连接 的 socket 通信 示例 。 

一 个 原生 socket 通信 示例 。 


8.1.1 Echo Android 应 用 项 目 


打开 Eclipse IDE， 按 照 下 列 步骤 创建 Echo 应 用 : 

(1) 打开 Android Application Project 对 话 框 。 

(2) 将 Application Name 设置 为 Echo。 

(3) 将 Project Name 设置 为 Echo。 

(4) 将 Package Name 设置 为 com.apress.echo。 

(5) 将 Build SDK 设置 为 Android 4.1。 

(6) 将 Minimum Required SDK 设置 为 API 8。 

(7) 单 击 Next 按钮 接受 其 他 设置 的 默认 值 。 

(8) 单 击 Next 按钮 选择 默认 图 标 为 启动 图 标 。 

(9) 取消 选中 Create activity， 并 且 单 击 Finish 按钮 创建 一 个 空 项 目 。 

(10) 进入 Project Explorer 视图 ， 通 过 Android Tools 上 下 文 菜单 项 打开 Android Native 
Support 向 导 。 

(11) 将 Library Name 设置 为 Echo。 

(12) 按照 向 导 要求 向 项 目 中 添加 原生 支持 。 


8.1.2 ”抽象 echo activity 


为 了 方便 重用 常用 功能 ， 需 要 在 定义 实际 的 activity 之 前 创建 一 个 抽象 activity 类 。 在 
Project Explorer 视图 中 展开 src 目录 ， 右 击 com.apress.echo 包 ， 在 上 下 文 菜单 中 选择 New | 
Class。 将 Name 设置 为 AbstractEchoActivity 并 单 击 Finish 按钮 。 在 Editor 视图 中 添加 如 程 
序 清单 8-1 所 示 的 类 文件 的 内 容 。 


程序 清单 8-1 ”AbstractEchoActivity.java 类 文件 的 内 容 


package com.apress.echo; 


import android.app.Activity; 

import android.os.Bundle; 

import android.os.Handler; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.EditText; 

import android.widget.ScrollView; 

import android.widget.TextView; 
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J/*# 
* 抽象 echo activity 对 象 . 
太 
* @author Onur Cinar 
A 
public abstract class AbstractEchoActivity extends Activity implements 
OnClickListener { 
/** 端口 号 ，*/ 
protected EditText portEdit; 


/** 服务 按钮 . */ 


protected Button startButton; 


/** 日 志 滚 动 . */ 
protected ScrollView logscroll; 


/xx 日 志 视图 .。*/ 


protected TextView logView; 


/xx 布局 ID. */ 


private final int layoutID; 


/** 

* 构造 函数 . 

# 

* @param layoutID 

* 布局 ID. 

sf 

public AbstractEchoActivity(int layoutID) { 
this.layoutID = layoutID; 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (layoutID); 


portEdit = (EditText) findViewById(R.id.port edit); 
startButton = (Button) findViewById(R.id.start button); 
logSscroll = (ScrollView) findViewById(R.id.1log scroll); 
logView = (TextView) findViewById(R.id.1log view); 


startButton.setOnClickListener (this); 


public void onClick(View view) { 
if (view == startButton) { 
onstartButtonClicked(); 
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/* 

* 在 开始 按钮 上 单 击 . 

Wf 
protected abstract void onstartButtonClicked(); 


/**# 
* 以 整 型 获取 端口 号 . 
* @return port number or null. 
wy 
protected Integer getPort() { 
Integer port; 


try { 

port = Integer.valueOf (portEdit.getText() .tostring()); 
} catch (NumberFormatException e) { 

port = null; 


return port; 


/太太 
* 记录 给 定 的 消息 
太 
* @param message 
* 日 志 消息 . 
和 
protected void logMessage (final String message) { 
runonUiThread (new Runnable() { 
public void run() { 
logMessageDirect (message); 


Ds; 


/太太 


* 直接 记录 给 定 的 消息 . 


和 
* Q@param message 
* 日 志 消息 . 
a 
protected void logMessageDirect (final String message) { 
logView.append (message); 
logView.append ("\n"); 
logSscroll.fullscroll (View.FOCUS DOWN); 


/太太 


* 抽象 异步 echo 任务 . 
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a 

protected abstract class AbstractEchoTask extends Thread { 
/** Handler 对 象 . */ 
private final Handler handler; 


/**# 

* 构造 函数 . 

Wk 

public AbstractEchoTask() { 
handler = new Handler (); 


/太太 
* 在 调用 线程 中 先 执行 回调 . 
ay 
protected void onPreExecute () { 
startButton.setEnabled (false); 
logView.setText (""); 


public synchronized void start() { 
OnPreExecute () 7 
super.start (); 


public void run() { 
onBackground (); 
handler.post (new Runnable() { 
public void run() { 
OnPostExecute () 7 


nD; 


/女友 
* 新 线程 中 的 背景 回调 . 
Wid 
protected abstract void onBackground(); 


/*#* 
* 在 调用 线程 中 后 执行 回调 . 
交大 
protected void onPostExecute() { 
startButton.setEnabled (true); 


static { 
System.1loadLibrary ("Echo"); 
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除了 处 理 绑 定 用 户 界面 组 件 这 类 的 日 常任 务 ，AbstractEchoActivity 还 提供 一 个 简单 的 
线程 实现 ， 以 使 应 用 在 一 个 单独 的 线程 而 不 是 UI 线 程 中 执行 网 络 操作 。 


8.1.3 ”echo 应 用 程序 字符 串 资源 


在 Project Explorer 视图 中 ， 展 开 res 资源 目录 。 展 开 values 子 目 录 并 双击 strings.xml， 
在 Editor 视图 中 打开 字符 串 资源 。 用 程序 清单 8-2 所 示 的 内 容 蔡 换文 件 内 容 。 


程序 清单 8-2 ”res/values/strings.xml 资源 文件 的 内 容 


<resources> 


<string name="app name">Echo</string> 

<string name="title activity echo server">Echo Server</string> 
<string name="port edit">Port Number</string> 

<string name="start server button">Start Server</string> 
<string name="title activity echo client">Echo Client</string> 
<string name="ip edit">IP Address</string> 

<string name="start client button">start Client</string> 
<string name="send button">Send</string> 

<string name="message edit">Message</string> 

<string name="title activity local echo">Local Echo</string> 
<string name="local port edit">Port Name</string> 


</resources> 


该 应 用 的 用 户 界 面 布局 将 参照 这 些 常 见 的 字符 串 资源 。 
8.1.4 ”原生 echo 模块 


原生 echo 模块 会 为 Java 应 用 程序 提供 原生 socket 方法 的 实现 。 在 Project Explorer 视 
图 中 为 原生 源 文件 展开 jni 目录 , 双击 Echo.cpp C++ 源 文件 , 用 程序 清单 8-3 所 示 的 一 组 辅 
助 函数 替换 其 内 容 ， 该 组 辅助 函数 有 助 于 socket 通信 示例 的 实现 。 

程序 清单 8-3 jni/Echo.cpp 文件 的 内 容 


// JNI 
#include <jni.h> 


// NULL 
#include <stdio.h> 


// va list, vsnprintf 
#include <stdarg.h> 


// errno 
#include <errno.h> 
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// strerror r, memset 
#include <string.h> 


// socket, bind, getsockname, listen, accept, recv, send, connect 
#include <sys/types.h> 
#include <sys/socket.h> 


// sockaddr un 
#include <sys/un.h> 


// htons, sockaddr in 
#include <netinet/in.h> 


// inet ntop 
#include <arpa/inet.h> 


// close, unlink 
#include <unistd.h> 


// offsetof 
#include <stddef.h> 


// 最 大 日 志 消 息 长 度 
#define MAX LOG MESSAGE LENGTH 256 


// 最 大 数据 缓冲 区 大 小 
#define MAX BUFFER SIZE 80 


/**# 
* 将 给 定 的 消息 记录 到 应 用 程序 . 


* @param env JNIEnv interface. 
* @param obj object instance. 
* @param format message message format and arguments. 
二 
static void LogMessage( 
JUNIEnVk env, 
jobject obj, 
const char* format, 
se) 


// 缓存 日 志方 法 ID 
static jmethodID methodID = NULL; 


// 如 果 方 法 ID 未 缓存 
if (NULL == methodID) 
// 从 对 象 获取 类 


jclass clazz = env->GetObjectClass (obj) 
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// 从 给 定 方法 获取 方法 ID 
methodID = env->GetMethodID (clazz, "logMessage", 
"(Ljava/lang/string;)V"); 


// 释放 类 引用 


env->DeleteLocalRef (clazz); 


} 


// 如 果 找 到 方法 
if (NULL != methodID) 
{ 
// 格式 化 日 志 消息 
char buffer[MAX LOG MESSAGE LENGTH]; 


va list ap7 

va start (ap, format); 

vsnprintf (buffer, MAX LOG MESSAGE LENGTH, format, ap); 
va_end(ap); 


// 将 缓冲 区 转换 为 Java 字符 串 


jstring message = env->NewStringUTF (buffer) 


// 如 果 字 符 串 构 造 正确 
if (NULL != message) 
{ 
// 记录 消息 
env->CallVoidMethod (obj, methodID, message); 


// 释放 消息 引用 


env->DeleteLocalRef (message) 7 


/**# 
* 用 给 定 的 异常 类 和 异常 消息 抛 出 新 的 异常 
太 


* @param env JNIEnv interface. 

* @param className class name. 

* @param message exception message. 

# 

static void ThrowException( 
JNIEnv* env, 
const char* className, 
const char* message) 


// 获取 异常 类 


jclass clazz = env->FindClass (className); 
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// 如 果 异 常 类 未 找到 
if (NULL != clazz) 
本 

// 抛 出 异常 


env->ThrowNew (clazz, message); 


// 释放 原生 类 引用 


env->DeleteLocalRef (clazz); 


/* 


灵 


* 用 给 定 异 常 类 和 基于 错误 号 的 错误 消息 抛 出 新 异常 


* @param env JNIEnv interface. 
* @param className class name. 
* @param errnum error number. 
Wg 
static void ThrowErrnoException( 
JNIEnv* env, 
const char* className, 
int errnum) 


char buffer[MAX LOG MESSAGE LENGTH]; 


// 获取 错误 号 消息 
if (-1 == strerror rl(errnum, buffer, MAX LOG MESSAGE LENGTH)) 
{ 
strerror rl(errno, buffer, MAX LOG MESSAGE LENGTH); 
) 


// 抛 出 异常 
ThrowException(env, className, buffer); 


} 
在 学 习 本 章 的 过 程 中 ， 需 要 通过 添加 各 种 socket 函数 的 实现 对 这 段 源 代码 进行 大 幅度 
修改 。 


8.2 用 TCP sockets 实现 面向 连接 的 通信 


通过 TCP socket 实现 的 面向 连接 的 通信 为 应 用 程序 提供 了 健壮 的 、 容 错 的 通信 介质 。 
该 类 连接 在 通信 的 整个 生命 周期 内 维护 一 个 开放 的 连接 ， 并 且 透 明 地 处 理应 用 程序 中 包 的 
校 核 和 错误 检查 。 为 了 说 明 用 socket 建立 通信 和 信息 交换 的 过 程 ， 需 要 修改 示例 Echo 应 
用 程序 使 其 包含 TCP 服务 器 和 客户 端的 activities。 
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8.2.1 Echo Server Activity 的 布局 


在 Project Explorer 视图 中 , 展开 res 目录。 展开 layout 子 目录 并 创建 一 个 名 为 activity 
echo_server.xml 的 新 布局 文件 。 在 Editor 视图 中 用 程序 清单 8-4 所 示 的 内 容 蔡 换文 件 的 
内 容 。 


程序 清单 8-4 res/layoutiactivty_echo_server.xml 文件 的 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent™" 
android:orientation="vertical" > 


<LinearLayout 

android:layout width="match parent" 

android:layout height="wrap content" > 
<EditText 

android:id="@+id/port edit" 
:layout width="wrap_content" 
:layout height="wrap_content" 
:layout weight="1" 
:hint="@string/port edit" 
android:inputType="number" > 


<requestFocus /> 
</EditText> 


<Button 
android:id="@+id/start button" 
:layout width="wrap_content" 
:layout height="wrap_content" 
:layout weight="1" 
android:text="@string/start server button" /> 


</LinearLayout> 


<ScrollView 
android:id="@+id/log_ scroll" 
android:layout width="match parent" 
android:layout height="match parent" > 


<TextView 
android:id="@+id/log view" 
android:layout width="match parent" 
android:layout height="wrap_ content" /> 
</ScrollView> 


</LinearLayout> 
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Echo Server 提供 一 个 简单 的 用 户 界面 ， 该 界面 用 来 获取 绑 定 服务 器 的 端口 号 ， 同 时 在 
运行 时 显示 原生 TCP 服务 器 的 状态 更 新 。 


8.2.2 Echo Server Activity 


打开 Project Explorer 视图 ， 在 src 目录 下 创建 一 个 名 为 EchoServerActivityjava 的 新 类 
文件 。 在 Editor 视图 中 添加 如 程序 清单 8-5 所 示 的 文件 内 容 。 


程序 清单 8-5 “EchoServerActivity java 文件 的 内 容 


package com.apress.echo; 


/** 
* Echo server. 
* @author Onur Cinar 
sy 
public class EchoServerActivity extends AbstractEchoActivity { 
/** 
* 构造 函数 . 
Sf 
public EchoServerRctivity() { 
super (R.layout .activity echo server); 


} 


protected void onStartButtonClicked() { 
Integer port = getPort(); 
if (port != null) { 
ServerTask serverTask = new ServerTask (port); 
serverTask.start (); 


有 


/** 
* 根据 给 定 端口 启动 TCP 服务 器 . 


* @param port 

* 端口 号 . 

* @throws Exception 

eA 

private native void nativeSstartTcpServer (int port) throws Exception; 


/妇女 
* 根据 给 定 端口 启动 UDP 服务 . 


大 


* @param port 

* 端口 号 . 

* @throws Exception 
wy 
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private native void nativeStartUdpServer (int port) throws Exception; 


/* 

* 服务 器 端 任务 . 

5 

private class ServerTask extends AbstractEchoTask { 
/** 端口 号 . */ 
private final int port; 


i 


* 构造 函数 . 


大 


* @param port 

* 端 口号 . 

3 

public ServerTask(int port) { 
this.port = port; 

} 


protected void onBackground() { 
logMessage ("Starting server."™); 


try { 
nativestartTcpServer (port); 
} catch (Exception e) { 


logMessage (e.getMessage ()); 
} 


logMessage ("Server terminated."); 


i 


EchoServerActivity 从 用 户 那 里 获得 必要 的 参数 ， 并 在 一 个 单独 的 线程 中 启动 native- 
StartTcpServer 函数 和 原生 TCP 客户 端 实现 。 


8.2.3 ”实现 原生 TCP Server 


在 Project Explorer 中 选择 EchoServerActivity, 在 External Tools 菜单 中 选择 Generate C 
and C++ Header File 生成 原生 头 文件 。 在 Project Explorer 中 展开 jni 子 目录 ,在 编辑 器 中 打 
开 Echo.cpp 源 文件 。 把 光标 移 到 文件 开始 处 ， 插 入 程序 清单 8-6 所 示 的 include 语句 以 包 
含 原生 方法 声明 。 
程序 清单 8-6 ”包含 EchoServerActivity 头 文件 


#include "com apress echo EchoServerActivity.h" 
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1. 创建 一 个 Socket: socket 


socket 用 一 个 名 为 socket 描述 符 的 整数 表示 。 除 了 创建 socket 的 函数 外 ，Socket API 
函数 需要 有 效 的 socket 描述 符 才 能 正常 工作 。 可 以 用 socket 函数 来 创建 socket。 


int socket (int domain, int type, int protocol); 


为 了 创建 新 的 socket，socket 函数 需要 提供 以 下 参数 : 


Domain: 指定 将 会 产生 通信 的 socket 域 ， 并 且 选 择 将 用 到 的 协议 族 。 在 本 书 编写 

时 ，Android 平台 支持 以 下 协议 族 : 

> PF LOCAL: 主机 内 部 通信 协议 族 ， 该 协议 族 使 物理 上 运行 在 同一 台 设备 上 的 
应 用 程序 可 以 用 Socket APIs 彼此 通信 。 

> ”PF_INET: Intemet 第 4 版 协议 族 , 该 协议 族 使 应 用 程序 可 以 与 网 络 上 其 他 地 方 
运行 的 应 用 程序 进行 通信 。 

Type: 指定 通信 的 语义 ， 支 持 以 下 几 种 主要 的 socket 类 型 。 

> SOCK_ STREAM: 提供 使 用 TCP 协议 的 、 面向 连接 的 通信 Stream socket 类 型 。 

> SOCK_DGRAM: 提供 使 用 UDP 协议 的 、 无 连接 的 通信 Datagram socket 类 型 。 


。 Protocol: 指定 将 会 用 到 的 协议 。 对 于 大 多 数 协 议 族 和 协议 类 型 来 说 ， 只 能 使 用 一 


个 协议 。 为 了 选择 默认 协议 ， 该 参数 可 以 设 为 零 。 


如 果 创 建 了 合适 的 socket，socket 函数 返回 相关 的 socket 描述 符 ， 否 则 返回 -1 且 全 局 
变量 ermo 被 相应 地 设置 成 错误 值 。 

在 Editer 视图 中 ， 将 NewTcpSocket 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 
程序 清单 8-7 所 示 。 


程序 清单 8-7 NewTcpSocket 原生 辅助 函数 


/ 


S 


{ 


大大 


构造 新 的 TCP socket. 


eparam env JNIEnv interface. 
@param obj object instance. 
@return socket descriptor. 
@throws IOException 


和 半 


人 
tatic int NewTcpSocket (JNIEnv* env, jobject obj) 


// 构造 socket 
LogMessage (env, obj, "Constructing a new TCP socket..."); 
int tcpSocket = socket (PF INET, SOCK STREAM, 0); 


// 检查 socket 构造 是 否 正确 
if (-1 == tcpSocket) 
. 

// 抛 出 带 错 误 号 的 异常 


ThrowErrnoException (env, "java/io/IOException", errno); 
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} 


return tcpSocket; 


} 
该 辅助 函数 创建 了 一 个 新 的 TCP socket， 并 在 失败 时 抛 出 一 个 java.lang.IOException。 
2. 将 socket 与 一 个 地 址 绑 定 : bind 


当 用 socket 函数 创建 一 个 socket 后 , 该 socket 存 在 一 个 socket 族 空间 中 , 且 没 为 该 socket 
分 配 协议 地 址 。 为 了 使 客户 能 够 定位 到 这 个 socket 并 与 之 相连 , 它 需要 先 与 一 个 地 址 绑 定 ， 
可 以 用 bind 函数 将 socket 与 地 址 绑 定 。 


int bind(int socketDescriptor, const struct sockaddr* address,socklen 七 
addressLength); 


bind 函数 需要 以 下 参数 将 socket 与 地 址 绑 定 : 

e socket 描述 符 : 指定 将 绑 定 到 指定 地 址 的 socket 实例 

e@ address: 指定 socket 被 绑 定 的 协议 地 址 

ee address length: 指定 传递 给 函数 的 协议 地 址 结构 的 大 小 

不 同 协议 族 使 用 不 同 的 协议 地 址 。 PF_INET 协议 族 使 用 sockaddr_in structure 指定 协议 
地 址 。sockaddr in 结构 的 定义 见 程序 清单 8-8。 


程序 清单 8-8 ”sockaddr_in 地 址 结构 


struct sockaddr in { 
sa family t sin family; 
unsigned short int sin port; 
struct in addr sin addr; 


} 
如 果 socket 正确 绑 定 ，bind 函数 就 返回 零 ， 否 则 返回 -1 且 errno 全 局 变量 被 设置 为 相 


应 的 错误 值 。 
在 Editor 视图 中 ， 将 BindSocketToPort 辅助 函数 添加 到 Echo.cpp 原生 模块 源 文件 中 ， 
如 程序 清单 8-9 所 示 。 


程序 清单 8-9 ”BindSocketToPort 原生 辅助 函数 


/妇女 


* 将 socket 绑 定 到 某 一 端口 号 . 


# 
* @param env JNIEnv interface. 
* @param obj object instance. 
* @param sd socket descriptor. 
* Q@param port Port number or zero for random port. 
* @throws IOException 
i 
static void BindSocketToPort( 

JNIEnv* env, 
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jobject obj, 
int sd, 
unsigned short port) 


struct sockaddr in address; 


// 绑 定 socket 的 地 址 
memset (&address，0，sizeof (address)) 7 
address.sin family = PF INET; 


// 绑 定 到 所 有 地 址 
address.sin addr.s addr = htonl (INADDR ANY); 


// 将 端口 转换 为 网 络 字 节 顺序 
address.sin port = htons (port) 7 


// 绑 定 socket 
LogMessage (env, obj, "Binding to port %hu.", port); 
if (-1 == bind(sd, (struct sockaddr*) &address, sizeof (address))) 
上 
// 抛 出 带 错误 号 的 异常 


ThrowErrnoException(env, "java/io/IOException", errno); 


} 


如 果 在 地 址 结构 中 将 端口 号 设置 为 零 , bind 函数 会 将 第 一 个 可 用 端口 号 分 配给 socket。 
可 以 用 getsockname 函数 在 socket 中 检索 到 这 个 端口 号 。 在 Editor 视图 中 , 将 GetSocketPort 
辅助 函数 追加 到 Echo.cpp 原生 模块 源 文 件 中 ， 如 程序 清单 8-10 所 示 。 


程序 清单 8-10 ”GetSocketPort 原生 辅助 函数 


/ 大 
获取 当前 绑 定 的 端口 号 socket . 


eparam env JNIEnv interface. 
@param obj object instance. 
eparam sd socket descriptor. 
@return port number. 
@throws IOException 


站 


SF 

static unsigned short GetSocketPort( 
JUNIEnVx* env, 
jobject obj, 
int sd) 


unsigned short port = 0; 
struct sockaddr in address; 


socklen t addressLength = sizeof (address); 


// 获取 socket 地 址 
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if (-1 == getsockname (sd, 
(struct sockaddr*) &address， 
&addressLength)) 


// 抛 出 带 错误 号 的 异常 

ThrowErrnoException(env, "java/io/IOException", errno); 
¥ 
Le 

// 将 端口 转换 为 主机 字 节 顺 序 


port = ntohs (address.sin _ Port) 7 


LogMessage (env, obj, "Binded to random port %hu.", port); 


} 


return port; 
} 
正如 你 看 到 的 ， 端 口号 不 是 直接 传递 到 sockaddr in 结构 中 ， 相 反 ， 先 用 htons 函数 做 
转换 ， 这 是 因为 主机 和 网 络 字 节 顺序 有 差别 。 


3. 网 络 字 节 排 序 


在 硬件 层 上 ， 不 同 的 机 器 体系 结构 使 用 不 同 的 数据 排序 和 表示 规则 ， 这 被 称 为 机 器 字 
节 排序 或 字 节 序 。 例 如 : 

e Big-endian 字 节 顺序 首先 储存 最 重要 的 字 节 。 

e Little-endian 字 节 顺序 首先 储存 最 不 重要 的 字 节 。 

字 节 排序 规则 不 同 的 机 器 不 能 直接 交换 数据 。 为 了 使 字 节 排序 规则 不 同 的 机 器 能 在 网 
络 上 通信 ，JIP 将 big-endian 字 节 排序 声明 为 官方 的 数据 传输 网 络 字 节 排 序 规则 。 

由 于 Java 虚拟 机 已 经 在 使 用 big-endian 字 节 排序 了 ， 这 有 可 能 是 你 第 一 次 听 说 数据 的 
字 节 序 。Java 应 用 程序 在 进行 跨 网 络 通信 时 ， 不 一 定 要 做 数据 转换 。 与 此 相反 ， 因 为 Java 
虚拟 机 不 执行 原生 组 件 ， 所 以 它们 使 用 机 器 字 节 排序 。 

。 ARM 和 x86 机 器 结构 使 用 little-endian 字 节 排序 

e MIPS 机 器 结构 使 用 big-endian 字 节 排序 

在 网 络 上 通信 时 ， 原 生 代码 需要 在 机 器 字 节 排序 和 网 络 字 节 排 序 间 做 必要 的 转换 。 

socket 库 提供 了 一 组 便利 函数 ， 使 原生 应 用 程序 可 以 透明 地 处 理 字 节 排序 转换 。 这 些 
函数 通过 sys/endian.h 头 文件 声明 。 


#include <sys/endian.h> 


该 头 文件 提供 了 以 下 的 便利 函数 : 

e@ htons 函数 : 将 unsigned short 从 主机 字 节 排序 转换 到 网 络 字 节 排序 。 

e@ ntohs 函数 : 和 htons 函数 相反 ， 将 unsigned short 从 网 络 字 节 排序 转换 到 主机 字 节 
排序 。 

e htonl 函数 : 将 unsigned integer 从 主机 字 节 排序 转换 到 网 络 字 节 排 序 。 
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e ntohl 函数 :和 htonl 函数 相反 ， 将 unsigned integer 从 网 络 字 节 排 序 转换 到 主机 字 
车 排序。 
采用 这 些 方便 的 方法 是 非常 有 益 的 ， 因 为 这 些 方法 的 实现 在 编译 时 是 基于 目标 机 器 体 
系 结构 定义 的 。 如 果 机 器 字 节 排序 不 同 于 网 络 字 节 排序 , 这 些 函 数 与 合适 的 转换 函数 映射 ， 
否则 它们 不 对 数据 执行 任何 操作 。 本 章 中 将 会 频繁 使 用 这 些 方便 的 函数 。 
让 端口 与 地 址 绑 定 不 足以 让 客户 端 与 之 相连 ， 应 用 程序 应 该 显 式 地 启动 对 输入 连接 的 
socket 的 监听 。 


4. 监听 进入 的 连接 : listen 
监听 socket 是 通过 listen 函数 完成 的 。 
int listen(int socketDescriptor, int backlog) 7 


为 了 启动 对 给 定 socket 上 输入 连接 的 监听 ，listen 函数 需要 提供 以 下 参数 : 
e ”socket 描述 符 : 指定 应 用 程序 想 要 监听 的 输入 连接 socket 实例 。 
e backlog: 指定 保存 挂 起 的 输入 连接 的 队列 大 小 。 如 果 应 用 程序 正在 忙于 为 客户 服 
务 ， 其 他 输入 连接 就 要 排队 ， 队 列 中 挂 起 的 连接 数 的 最 大 值 由 backlog 指定 。 当 输 
入 连接 达到 backlog 所 限定 的 值 时 ， 其 他 的 输入 连接 将 被 拒绝 。 
如 果 该 函数 成 功 , 返回 零 ; 否则 返回 -1 且 errno 全 局 变量 被 设置 为 相应 的 错误 ,在 Editor 
视图 中 ,将 ListenOnSocket 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文 件 中 ， 如 追加 内 容 程序 
清单 8-11 所 示 。 


程序 清单 8-11 ListenOnSocket 原生 辅助 函数 


/* 六 
* 监听 指定 的 待 处 理 连 接 的 backlog 的 socket， 当 backlog 已 满 时 拒绝 新 的 连接 . 


* @param env JNIEnv interface. 
* @param obj object instance. 
* @param sd socket descriptor. 
* @param backlog backlog size. 
* @throws IOException 
uy 
static void ListenOnSocket( 
UNIEnVx env, 
jobject obj, 
int sd, 
int backlog) 


// 监听 给 定 backlog 的 socket 

LogMessage (env, obj, 
"Listening on socket with a backlog of %d pending connections.", 
backlog); 


if (-1 == listenl(sd, backlog)) 
{ 
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// 抛 出 带 错误 号 的 异常 


ThrowErrnoException (env, "java/io/IOException", errno); 


} 


通过 listen 函数 监听 输入 连接 只 是 简单 地 将 输入 连接 放 进 一 个 队列 里 并 等 待 应 用 程序 
显 式 地 接受 它们 。 


5. 接受 传 入 连接 : accept 
accept 函数 用 来 显 式 地 将 输入 连接 从 监听 队列 里 取出 并 接受 它 。 


int accept (int socketDescriptor, struct sockaddr* address, socklen t* 
addressLength); 


accept 函数 是 一 个 阻塞 函数 。 如 果 在 监听 队列 中 没有 即将 到 来 的 输入 连接 请 求 ， 它 会 
使 调用 进程 进入 挂 起 状态 , 直到 有 新 的 输入 连接 到 达 。 为 了 接受 一 个 即将 到 来 的 输入 连接 ， 
accept 函数 需要 提供 以 下 参数 : 

e ”socket descriptor: 指定 应 用 程序 想 要 从 其 上 接受 输入 连接 的 socket 实例 。 

e address pointer: 提供 了 一 个 地 址 结构 ， 在 该 结构 中 填 入 被 连接 的 客户 协议 地 址 。 

如 果 应 用 程序 不 需要 该 信息 ， 它 可 以 被 设置 为 NULL。 
e@ address length pointer: 为 要 填 入 的 连接 客户 协议 地 址 提供 指定 大 小 的 内 存 空间 。 如 
果 不 需要 该 信息 ， 它 可 以 被 设置 为 NULL。 

如 果 accept 请 求 成 功 , 该 函数 返回 与 该 连接 实例 交互 时 将 会 用 到 的 客户 socket 描述 符 ; 
和 否则， 返回 -1 且 全 局 变量 errno 被 设置 为 合适 的 错误 值 。 

在 实例 应 用 程序 中 ,我 们 将 获取 关于 连接 客户 端的 信息 并 将 之 显示 在 activity 中 , 在 
Editor 视图 , 将 LogAddress 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文 件 中 , 如 程序 清单 8-12 
所 示 ， 该 源 文件 将 被 用 来 提取 和 展示 必要 的 信息 。 


程序 清单 8-12 ”LogAddress 原生 辅助 函数 


/**# 
* 记录 给 定 地 址 的 IP 地 址 和 端口 号 . 


* @param env JNIEnv interface. 
* @param obj object instance. 
* @param message message text. 
* @param address adress instance. 
* @throws IOException 
I 
static void Logaddress ( 
UNIEnVx* env, 
jobject obj, 
const char* message, 
const struct sockaddr in* address) 


char ip[INET ADDRSTRLEN]; 
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// 将 IP 地 址 转换 为 字符 串 

if (NULL == inet_ntop (PF INET, 
&(address->sin addqr)， 
ip, 
INET ADDRSTRLEN)) 


// 抛 出 带 错误 号 的 异常 


ThrowErrnoException(env, "java/io/IOException", errno); 


} 


else 
{ 
// 将 端口 转换 为 主机 字 节 顺序 


unsigned short port = ntohs (address->sin port); 


// 记录 地 址 


LogMessage (env, obj, "%s %s:$%hu.", message, ip, port); 


} 


在 Editor 视图 中 ， 将 程序 清单 8-13 所 示 的 AcceptOnSocket 辅助 函数 追加 到 Echo.cpp 
原生 模块 源 文件 中 。 就 像 之 前 所 提 到 的 ， 应 用 程序 会 用 这 个 函数 接收 待 输入 的 连接 。 


程序 清单 8-13 ”AcceptOnSocket 原生 辅助 函数 


. 大 
在 给 定 的 socket 上 阻塞 和 等 待 进来 的 客户 连接 


@param env JNIEnv interface. 
Q@param obj object instance. 
@param sd socket descriptor. 
Q@return client socket. 
@throws IOException 


站 外 外 站 外 下 


A 

static int AcceptOonSocket( 
JNIEnv* env, 
jobject obj, 
int sd) 


struct sockaddr in address; 
socklen t addressLength = sizeof (address); 


// 阻塞 和 等 待 进来 的 客户 连接 
// 并 且 接受 它 


LogMessage (env, obj, "Waiting for a client connection..."); 
int clientSocket = accept (sd, 


(struct sockaddr*) &address， 
&addressLength); 
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// 如 果 客 户 socket 无 效 


if (-1 == clientSocket) 


// 抛 出 带 错误 号 的 异常 

ThrowErrnoException(env, "java/io/IOException", errno); 
} 
else 
' 

// 记 录 地 址 


LogAddress (env, obj, "Client connection from 


，&address) 7 


} 


return clientSocket; 


} 

接收 即将 到 来 的 连接 时 , accept 函数 返回 新 的 socket 描述 符 可 用 于 与 客户 端 交换 数据 。 
6. 从 socket 接收 数据 : recv 

用 recv 函数 实现 从 socket 接收 数据 。 


ssize t recvl(int socketDescriptor, void* buffer, size t bufferLength, int 
flags); 

Tecv 函数 也 是 一 个 阻塞 函数 。 如 果 没有 从 给 定 的 socket 接收 到 数据 ， 它 会 使 调用 进程 
进入 挂 起 状态 ， 直 到 接收 到 可 用 数据 。 为 了 接受 即将 到 来 的 输入 连接 ，recv 函数 需要 提供 
以 下 参数 : 

e@ Socket descriptor: 指定 应 用 程序 想 要 从 中 接收 数据 的 socket 实例 。 

e buffer pointer: 指向 内 存 地 址 的 指针 ， 该 内 存 用 来 保存 从 socket 接收 的 数据 。 

e buffer length: 指定 缓冲 区 的 大 小 ，recy 函数 只 会 向 缓冲 区 中 写 入 该 参数 指定 大 小 

的 内 容 然后 返回 。 

e flags: 指定 接收 所 需要 的 额外 标志 。 

如 果 recv 函数 成 功 , 它 会 返回 从 socket 那里 接收 到 的 字 节 数 ; 否则 返回 -1 且 全 局 变量 
ermo 将 被 设置 为 相应 的 错误 。 如 果 该 函数 返回 零 , 表示 socket 连接 失败 。 在 Editor 视图 中 ， 
将 ReceiveFromSocket 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 , 如 程序 清单 8-14 所 示 。 


程序 清单 8-14 ”ReceiveFromSocket 原生 辅助 函数 


/** 
阻塞 并 接收 来 自 socket 的 数据 放 到 缓冲 区 . 


eparam env JNIEnv interface. 
@param obj object instance. 
@param sd socket descriptor. 
eparam buffer data buffer. 
Q@param bufferSize buffer size. 
@return receive size. 

Qthrows IOException 


LE 
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FE 
static ssize t ReceiveFromSocket( 
JNIEnv* env, 
jobject obj, 
int sd, 
char* buffer, 
size t bufferSize) 


// 阻塞 并 接收 来 自 socket 的 数据 放 到 缓冲 区 
LogMessage (env, obj, "Receiving from the socket...")7 
ssize t recvSize = recv(sd, buffer, buffersize - 1, 0); 


// 如 果 接 收 失败 
if (-1 == recvSize) 
{ 
// 抛 出 带 错误 号 的 异常 


ThrowErrnoException (env, "java/io/IOException", errno); 


} 


else 

{ 
// 以 NULL 结尾 缓冲 区 形成 一 个 字符 串 
buffer[recvSize] = NULL; 


// 如 果 数 据 接收 成 功 
if (recvSize > 0) 
{ 
LogMessage (env, obj, "Received %d bytes: %s", 
recvSize, buffer); 
} 


else 
{ 
LogMessage (env, obj, "Client disconnected."); 
} 
} 


return recvSize; 


} 


ReceiveFromSocket 函数 用 recv 函数 接收 数据 ， 这 些 数据 从 给 定 的 socket 写 入 到 给 定 
的 缓冲 区 中 。 若 出 现 错误 将 抛 出 一 个 IOException 异常 。 通 过 socket 发 送 数 据 也 是 以 类 似 
的 方式 完成 。 


7. 向 socket 发 送 数 据 : send 
向 socket 发 送 数 据 是 由 send 函数 完成 的 。 


ssize t send(int socketDescriptor, void* buffer, size t bufferLength, int 
flags); 


与 recv 函数 一 样 ，send 函数 也 是 一 个 阻塞 函数 。 如 果 socket 在 忙 着 发 送 数据 ， 它 会 使 
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调用 进程 进入 挂 起 状态 直到 socket 可 以 传输 数据 。 为 了 接收 即将 输入 的 连接 ，send 函数 需 
要 提供 以 下 参数 : 
e@ ”socket descriptor: 指定 应 用 程序 想 要 向 其 发 送 数 据 的 socket 实例 。 
e buffer pointer: 指向 内 存 地 址 的 buffer 指针 ， 该 内 存 是 给 定 的 socket 发 送 数 据 的 目 
的 地 。 
e@ buffer length: 指定 缓冲 区 的 大 小 。send 函数 只 会 向 缓冲 区 传输 该 参数 所 指定 大 小 
的 数据 然后 返回 。 
e flags: 指定 发 送 所 需要 的 额外 标志 。 
如 果 发 送 操作 成 功 ，send 函数 会 返回 传送 的 字 节 数 ， 否 则 返回 -1 且 全 局 变量 errno 将 
被 设置 为 相应 的 错误 。 与 recv 函数 一 样 , 如 果 该 函数 返回 0, 表示 socket 连接 失败 。 在 Editor 
视图 中 ， 将 SendToSocket 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 8-15 
所 示 。 


程序 清单 8-15 ”SendToSocket 原生 辅助 函数 
J/*# 


* 将 数据 缓冲 区 发 送 到 socket . 


* @param env JNIEnv interface. 
* Q@param obj object instance. 
* @param sd socket descriptor. 
* @param buffer data buffer. 
* @param bufferSize buffer size. 
+ Areturn sent size. 
* Qthrows IOException 
要 
static ssize t SendTosocket( 
JNIEnv* env, 
jobject obj, 
int sd, 
const char* buffer, 
size 七 bufferSize) 


// 将 数据 缓冲 区 发 送 到 socket 
LogMessage (env, obj, "Sending to the socket..."); 
ssize t sentSize = send(sd, buffer, buffersize, 0); 


// 如 果 发 送 失 败 
if (-1 == SentSize) 
{ 
// 抛 出 带 错 误 号 的 异常 
ThrowErrnoException (env, "java/io/IOException", errno); 
} 
else 
{ 
if (sentsize > 0) 
{ 
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LogMessage (env, obj, "Sent %d bytes: %s", sentSize, buffer); 
} 
else 
{ 
LogMessage (env, obj, "Client disconnected."); 
} 
} 


return sentSize; 


} 


SendToSocket 函数 用 send 函数 从 给 定 的 缓冲 区 向 给 定 的 socket 发 送 数据 。 若 发 送 数据 
时 出 现 错误 ， 会 抛 出 一 个 IOException 异常 。 现 在 ， 实 现 TCP 服务 器 流 需要 的 所 有 辅助 函 
数 都 已 经 准备 好 了 。 


8. 原生 TCP 服务 器 方法 


nativeStartTcpServer 原生 方法 是 TCP Echo 应 用 程序 的 核心 。 在 Editor 视图 中 ， 将 
nativeStartTcpServer 原生 方法 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 8-16 所 示 。 


程序 清单 8-16 ”nativeStartTcpServer 原生 方法 


void Java com apress echo EchoServerActivity _ nativeStartTcpSerVer( 
JNIEnv* env, 
jobject obj, 
jint port) 


// 构造 新 的 TCP socket. 
int serverSocket = NewTcpSocket (env, obj); 
if (NULL == env->ExceptionOoccurred()) 
{ 
// 将 socket 绑 定 到 某 端口 号 
BindSocketToPort (env, obj, serverSocket, (unsigned short) port); 
if (NULL != env->ExceptionOccurred()) 
goto exit; 
// 如 果 请 求 了 随机 端口 号 
if (0 == port) 
{ 
// 获取 当前 绑 定 的 端口 号 socket 
GetSocketPort (env, obj, serverSocket) 7 
if (NULL != env->ExceptionOccurred()) 
goto exit; 
} 


// 监听 有 4 个 等 待 连接 的 backlog 的 socket 
ListenOnSocket (env, obj, serverSocket, 4); 


if (NULL != env->ExceptionOccurred()) 
goto exit; 


// 接受 socket 的 一 个 客户 连接 
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int ClientSocket = AcceptOnSocket (env, obj, serverSocket); 
if (NULL != env->ExceptionOccurred()) 
goto exit; 


char buffer[MAX BUFFER SIZE]; 
S51ve tT reCvSives 
ssize 七 SentSize7 


// 接收 并 发 送 回 数据 
while (1) 
{ 

// 从 socket 中 接收 


recvSize = ReceiveFromSocket (env, obj, clientSocket, 
buffer, MAX BUFFER SIZE); 


if ((0 == recvSize) || (NULL != env->ExceptionOccurred()) 
break; 


// 发 送 给 socket 
sentSize = SendToSocket (env, obj, clientSsocket, 
buffer, (size t) recvSize); 


if ((0 == SentSize) || (NULL != env->ExceptionOccurred()) 
break; 


} 
// 关闭 客户 端 socket 


close(clientSocket); 


} 


exit: 
if (serverSocket > 0) 


{ 


Close (serverSocket); 
} 
i 
通过 本 节 指 定 的 原生 辅助 函数 ， 在 参数 提供 的 端口 上 打开 了 一 个 服务 器 socket 并 等 待 
输入 连接 。 当 输入 连接 请 求 到 达 时 ， 会 接收 该 连接 ， 然 后 开始 在 客户 socket 上 接收 数据 并 
回 显 传 到 客户 端的 字 节 数 。 


8.2.4 ”Echo 客户 端 Activity 布局 


在 Project Explorer 视图 中 ， 展 开 resources 下 的 res 目录 。 展 开 layout 子 目 录 ， 创 建 一 
个 名 为 activity_echo_client xml 的 新 布局 文件 。 在 Editor 视图 中 ， 用 程序 清单 8-17 所 示 内 
容 和 替换 文件 原来 的 内 容 。 
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程序 清单 8-17 ”res/layout/activity_echo_client.xml 文件 的 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match Parent" 
android:orientation="vertical" > 


<EditText 
android:id="@+id/ip edit" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="@string/ip edit" > 


<requestFocus /> 
</EditText> 


<EditText 
android:id="@+id/port edit" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:hint="@string/port edit" 
android:inputType="number" /> 


<EditText 
android:id="@+id/message edit" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:hint="@string/message edit" /> 


<Button 
android:id="@+id/start button" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:text="@string/start client button" /> 


<SscrollView 
android:id="@+id/log_ scroll" 
android:layout width="match parent" 
android:layout height="0dip" 
android:layout weight="1.0" > 


<TextView 
android:id="@+id/log view" 
android:layout width="match parent" 
android:layout height="wrap content" /> 
</ScrollView> 


</LinearLayout> 
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Echo 客户 端 提供 了 一 个 简单 的 用 户 接口 以 获得 远程 PP 地 址 、 端 口号 以 及 来 自用 户 的 
消息 负载 ， 同 时 在 运行 时 显示 原生 TCP 客户 端的 更 新 状态 信息 。 


8.2.5 “Echo 客户 端 Activity 


打开 Project Explorer 视图 , 在 src 目录 下 创建 名 为 EchoClientActivity. java 的 新 的 类 文 
件 ， 在 Editor 视图 中 添加 如 程序 清单 8-18 所 示 的 文件 内 容 。 


程序 清单 8-18 ”EchoClientActivity.java 文件 的 内 容 


package com.apress.echo; 


import android.os.Bundle; 
import android.widget.EditText; 


/** 
* Echo 客户 端 . 


* @author Onur Cinar 

wt 

public class EchoClientActivity extends RbstractEchoRctivity { 
/xx IP 地 址 . */ 
private EditText ipEdit; 


/xx 消息 编辑 ，*/ 


private EditText messageEdit; 


/** 
* 构造 函数 . 
a 
public EchoClientActivity() { 
super (R.layout .activity echo client); 


} 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 


ipEdit = (EditText) findViewById(R.id.ip edit); 
messageEdit = (EditText) findViewById(R.id.message edit); 
} 


protected void onstartButtonClicked() { 
String ip = ipEdit.getText() .tostring(); 
Integer port = getPort(); 
String message = messageEdit.getText() .tostring(); 


if ((0 != ip.length()) && (port != null) 


&& (0 != message.length())) { 
ClientTask clientTask = new ClientTask(ip, port, message); 
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clientTask.start (); 


/** 

* 根据 给 定 服务 器 IP 地 址 和 端口 号 启动 TCP 客户 端 ， 并 且 发 送 给 定 消息 . 
* @param ip 

* IP 地 址 

* @param port 

* 端口 号 

* @param message 

* 消息 文本 

* @throws Exception 

be 


private native void nativestartTcpClient (string ip, int port, 
String message) throws Exception; 


/妇女 
* 客户 端 任务 . 
a 
private class ClientTask extends AbstractEchoTask { 
/** 连接 的 IP 地 址 . */ 


private final String ip; 


/** 端口 号 ，*/ 


private final int port; 


/** 发 送 的 消息 文本 .*/ 


private final String message; 


A 荔 
构造 函数 . 


eparam ip 
连接 的 IP 地 址 . 
Q@param port 
连接 的 端口 号 . 
@param message 


发 送 的 消息 文本 


LC 


4 


a 

public ClientTask (String ip, int port, String message) { 
this.ip = ip; 
this.port = port; 
this.message = message; 


protected void onBackground() { 
logMessage ("Starting client."); 
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try { 

nativeStartTcpClient (ip, port, message); 
} catch (Throwable e) { 

logMessage (e.getMessage ()); 


logMessage ("Client terminated."); 


} 


EchoClientActivity 从 用 户 那 里 获得 了 必要 的 参数 ， 并 在 一 个 单独 的 线程 中 打开 了 
nativeStartTcpClient 函数 和 TCP 客户 实现 。 


8.2.6 ”实现 原生 TCP 客户 端 


在 Project Explorer 视图 中 选择 EchoClientActivity， 然 后 在 External Tools 菜单 中 选择 
Generate C and C++ Header File 以 生成 原生 头 文件 。 在 Project Explorer 的 编辑 器 中 打开 
Echo.cpp 源 文件 。 在 该 源 文件 顶部 插入 include 语句 ， 如 程序 清单 8-19 所 示 。 


程序 清单 8-19 ”包含 EchoClientActivity 头 文件 


#include "com apress echo EchoClientActivity.h" 


该 头 文件 包含 nativeStartTcpClient 函数 的 函数 声明 。 在 实现 这 个 函数 之 前 ， 需 要 定义 
-个 用 来 和 地 址 进行 连接 的 辅助 函数 。 


1. 与 地 址 连接 : connect 
通过 提供 协议 地 址 来 连接 socket 和 server socket， 这 是 由 connect 函数 完成 的 。 


int connect (int socketDescriptor, const struct sockaddr *address, socklen 七 
addressLength); 


为 了 接收 即将 到 来 的 输入 连接 ，connect 函数 需要 提供 以 下 参数 : 

e ”socket descriptor: 指定 应 用 程序 想 要 连接 协议 地 址 的 socket 实例 。 

e address: 指定 socket 要 连接 的 协议 地 址 。 

e address length: 指定 所 提供 的 地 址 结构 的 长 度 。 

如 果 尝 试 连接 成 功 ，connect 函数 返回 零 ; 否则 返回 -1 且 将 全 局 变量 ermo 设置 为 相应 
的 错误 。 在 Editor 视图 中 , 将 ConnectToAddress 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 
中 ， 如 程序 清单 8-20 所 示 。 


程序 清单 8-20 ”ConnectToAddress 原生 辅助 函数 


/** 
* 连接 到 给 定 的 IP 地 址 和 给 定 的 端口 号 . 


* @param env JNIEnv interface. 
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* Q@param obj object instance. 
* @param sd socket descriptor. 
* @param ip IP address. 
* @param port port number. 
* @throws IOException 
nf 
static void ConnectToAddress!( 
JNIEnv* env, 
jobject obj, 
int sd, 
const char* ip, 
unsigned short port) 


// 连接 到 给 定 的 IP 地 址 和 给 定 的 端口 号 


LogMessage (env, obj, "Connecting to $%Ss:g%uh..."，ip，Pport) 7 
struct sockaddr in address; 


memset (&address, 0, sizeof (address)); 
address.sin family = PF_INET; 


// 将 IP 地 址 字符 串 转换 为 网 络 地 址 
if (0 == inet_aton(ip，&(address.sin addr))) 
{ 
// 抛 出 带 错误 号 的 异常 
ThrowErrnoException(env, "java/io/IOException", errno); 
} 
else 
{ 
// 将 端口 号 转换 为 网 络 字 节 顺序 
address.sin port = htons (port); 
// 转换 为 地 址 
if (-1 == connect(sd, (const sockaddr*) &address, 
sizeof (address))) 
{ 
// 抛 出 带 错误 号 的 异常 
ThrowErrnoException (env, "java/io/IOException", errno); 
} 
else 
{ 


LogMessage (env, obj, "Connected."); 
} 


在 socket 与 一 个 协议 地 址 连接 时 ，POSIX Socket API 函数 可 以 被 用 于 在 应 用 程序 和 
server 之 间 交 换 数据 。 
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2. 原生 TCP Client 方法 


nativeStartTcpClient 原生 方法 是 TCP Echo 应 用 程序 的 客户 端 片段 。 在 Editor 视图 中 ， 
将 nativeStartTcpClient 原生 方法 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 8-21 
所 示 。 


程序 清单 8-21 nativeStartTcpClient 原生 方法 


void Java com apress echo EchoClientActivity nativestartTcpClient( 
JNIEnv* env, 
jobject obj, 
jstring ip, 
jint port, 
jstring message) 


// 构造 新 的 TCP socket. 
int clientSocket = NewTcpSocket (env, obj); 
if (NULL == env->ExceptionOccurred()) 
{ 
// 以 Cc 字符 串 形式 获取 IP 地 址 
const char* ipAddress = env->GetSstringUTFChars (ip, NULL); 
if (NULL == ipAddress) 
goto exit; 


// 连接 到 IP 地 址 和 端口 
ConnectToAddress (env, obj, clientSocket, ipAddress, 
(unsigned short) port); 


// 释放 IP 地 址 
enV->ReleaseStringUTEFChars (ip, ipAddress); 


// 如 果 连 接 成 功 
if (NULL != env->ExceptionOccurred()) 
goto exit; 


// 以 c 字 符 串 形式 获取 消息 
const char* messageText = enV->GetStringUTEChars (message, NULL); 
if (NULL messageText) 

goto exit; 


// 获取 消息 大 小 


jsize messageSize = env->GetStringUTFLength (message); 


// 发 送 消息 给 socket 


SendToSocket (env, obj, clientSocket, messageText, messageSize); 


// 释放 消息 文本 


env->ReleaseSstringUTFChars (message, messageText); 
// 如 果 发 送 未 成 功 


212 


第 8 章 POSIX Socket API: 面向 连接 的 通信 


if (NULL != env->ExceptionOccurred()) 
goto exit; 


char buffer[MAX BUFFER SIZE]; 


// 从 socket 接收 


ReceiveFromSocket (env, obj, clientSocket, buffer, 
MAX BUFFER SIZE); 


exit: 
if (clientSocket > -1) 
‘ 


close (clientSsocket); 
} 
} 


通过 本 节 指定 的 原生 辅助 函数 , 打开 了 一 个 socket 并 且 将 它 与 参数 指定 的 了 P 地 址 及 端 
口号 连接 。 连 接 建立 起 来 之 后 ， 会 通过 socket 发 送 提供 的 消息 文本 、 切 换 到 接收 模式 ， 并 
显示 从 socket 接收 的 数据 。 如 果 一 切 顺利 ， 同 样 的 数据 应 该 在 TCP Echo 服务 器 回 显 。 在 
执行 应 用 程序 之 前 ，Echo TCP 客户 和 服务 器 activities 需要 被 添加 到 Android Manifest 文 
件 中 。 


8.2.7 更 新 Android Manifest 


在 Project Explorer 视图 中 打开 AndroidManifestxml, 用 程序 清单 8-22 所 示 内 容 替 换文 
件 原来 的 内 容 。 


程序 清单 8-22 ”AndroidManifest.xml 文件 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.apress.echo" 
android:versionCode="1" 
android:versionName="1.0" > 
<uses-sdk 
android:minsdkVersion="8" 
android:targetSdkVersion="15"” /> 


<uses-permission android:name="android.permission.INTERNET" /> 


<application 

android:icon="@drawable/ic launcher" 

android:1label="@string/app_name" 

android:theme="@style/AppTheme" > 

<activity 
android:name=" .EchoServerActivity" 
android:label="@string/title activity echo server" 
android:launchMode="singleTop" > 
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<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
<activity 
android:name=".EchoClientActivity" 
android:label="@string/title activity echo client" 
android:launchMode="singleTop" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 
android:name="android.intent .category.LAUNCHER" /> 
</intent-filter> 


</activity> 
</application> 
</manifest> 
重新 生成 Android 项 目 以 使 修改 生效 。 现 在 示例 应 用 程序 现在 已 经 准备 好 ， 可 以 进行 


测试 了 。 
8.2.8 ”运行 TCP Sockets 示例 


为 了 测试 TCP Echo 应 用 程序 , 需要 建立 两 个 Android Emulator 实例 。 用 同样 的 设置 创 
建 一 个 新 的 Android Emulator 实例 。 用 Eclipse IDE 在 两 个 单独 的 Android Emulator 实例 上 
启动 EchoClientActivity 和 EchoServerActivity。 


1. 配置 Echo TCP 服务 器 


如 图 8-1 所 示 ，EchoServerActivity 会 提供 一 个 简单 的 用 户 界面 ,用 来 指定 TCP 服务 器 
在 其 上 接收 连接 的 端口 号 。 


© Echo Server 


Port Number Start Server 


8-1 ”Echo TCP 服务 器 用 户 接口 


e 将 Port Number 设置 为 0。 这 会 从 bind 函数 请 求 分 配 一 个 随机 端口 。 
e@ 单 击 Start Server 启动 Echo TCP 服务 器 。 


214 


第 8 章 POSIX Socket API: 面向 连接 的 通信 


TCP 服务 器 开启 后 ，bind 函数 会 将 第 一 个 可 用 端口 号 分 配给 server socket， 且 该 端口 
号 会 在 屏幕 上 显示 ， 如 图 8-2 所 示 。 


3:16| 


@ Echo Server 
wp 


d Start Server 


-一 一 


Binding to port 0. 
Binded to random po 
Listening on socket with-abacklog of 4 pending connections. 


aiting for a client connection... 


图 8-2 Echo TCP 服务 器 绑 定 到 一 个 随机 端口 号 
记录 该 端口 号 ， 因 为 连接 Echo TCP Client 和 TCP Server 时 会 用 到 它 。 
2. TCP 的 连通 模拟 器 


因为 Echo TCP Client 和 TCP Server 都 运行 在 单独 的 Android Emulator 实例 上 , 不 能 直 
接 在 它们 上 建立 连接 。Android Emulator 作为 一 个 虚拟 网 络 上 的 虚拟 设备 ， 运 行 在 一 个 沙 
箱 环境 中 。 在 Android Emulator 上 运行 的 应 用 程序 只 能 和 Android Emulator 进程 的 宿主 机 
器 进行 通信 。 为 了 使 TCP Client 和 TCP Server 进行 通信 ，TCP 端口 号 应 该 通过 宿主 机 来 桥 
接 。 这 可 以 通过 Android Debug Bridge(adb) 提 供 的 端口 转发 功能 来 完成 。 

根据 所 安装 的 操作 系统 ， 打 开 一 个 命令 提示 符 或 终端 窗口 ， 如 程序 清单 8-23 所 示 , 用 
你 之 前 记录 的 端口 号 蔡 换 <port number>、 用 Android Emulator 实例 的 设备 名 替换 <emulator 
name> 并 执行 以 下 命令 。 


程序 清单 8-23 ”通过 adb 端口 转发 
adb -s <emulator-name> forward tcp:<port number> tcp:<port number> 


这 会 将 Android Emulator 上 的 <port number> 与 主机 上 的 <port number> 喘 射 。 任 何 输入 
到 主机 上 端口 号 所 指定 端口 的 连接 都 会 通过 adb 转发 到 Android Emulator 的 指定 端口 上 。 
端口 转发 是 一 种 运行 时 设置 ， 一 旦 Android Emulator 停止 ， 它 将 会 被 清除 。 


注意 : 
如 果 你 正在 使 用 防火 墙 应 用 程序 ， 请 确保 输入 连接 的 端口 号 是 开放 的 。 
3. 配置 Echo TCP 客户 端 


EchoClientActivity 会 提供 一 个 如 图 8-3 所 示 的 简单 用 户 界 面 ， 它 用 来 指定 卫 地 址 、 要 
连接 的 TCP 服务 器 的 端口 号 和 要 传送 的 信息 。 
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- 24 BB 1:32 
@ Echo Client 


le Address 


Port Number 


Message 


Start Client 
[一 


8-3 ”Echo TCP 客户 端 用 户 接口 


请 按照 以 下 步骤 启动 TCP echo 客户 端 应 用 程序 : 

(1) 将 他 Address 设置 为 10.0.2.2。 这 是 可 用 来 与 Android Emulator 主机 进行 通信 的 静 
态 也 地址。 

(2) 将 Port Number 设置 为 你 之 前 记录 的 端口 号 。 

(3) 将 Message 设置 为 test 或 其 他 你 想 要 发 送 给 服务 器 的 字符 串 。 

(4) 单 击 Start Client 按钮 启动 Echo TCP 客户 端 。 

单 击 Start Client 按钮 后 , Echo TCP 客户 端 会 与 运行 在 其 他 Android Emulator 实例 上 的 
Echo TCP 服务 器 连接 ， 并 且 它 会 发 送 消 息 有 效 负载 。 客 户 端 和 服务 器 activity 都 会 显示 
socket 事件 以 及 被 传输 的 消息 ， 如 图 8-4 所 示 。 


© Echo Server 


0 Start Server 


tarting server. 
onstructing a new TCP socket.. 
Binding to port 0 
Binded to random port 51674 
Listening on socket with a backlog of 4 pending connections 
aiting for a client connection... 
lient connection from 127.0.0.1:39325 
Receiving from the socket 
Received 4 bytes: test 
Sending to the socket.. 


Sent 4 bytes: test 
Receiving from the socket. 


8-4 ”Echo TCP 客户 端 交换 消息 


面向 连接 的 协议 (如 TCP) 为 需要 可 靠 通信 媒介 的 应 用 程序 提供 无 差错 的 沟通 渠道 以 正 
常 运行 。 这 是 以 维持 一 个 打开 的 连接 为 代价 完成 的 。 某 些 应 用 程序 仍然 可 以 执行 而 不 必 保 
持 连接 信道 , 如 媒体 应 用 程序 。 POSIX Socket API 也 在 原生 层 提供 了 对 无 连接 通信 的 支持 。 


第 8 章 POSIX Socket API: 面向 连接 的 通信 


8.3 小 结 
本 章 深入 探讨 了 Bionic 库 为 面向 连接 的 通信 提供 的 POSIX Socket API。 学 习 了 使 用 


TCP 协议 的 客户 端 和 服务 器 ， 本 书 接 下 来 的 两 章 将 继续 讨论 POSIX Socket API。 第 9 章 开 
始 讨论 无 连接 通信 的 POSIX Socket API。 
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山 


第 


POSIX Socket API: 
无 连接 的 通信 


第 8 章 通过 一 个 使 用 TCP 协议 的 、 面 向 连接 通信 的 应 用 程序 示例 探讨 了 POSIX Socket 
APIs, 本 章 将 学 习 在 Android 应 用 程序 和 远 端 建立 无 连接 通信 的 方法 。 无 连接 通信 通过 UDP 
socket 提供 轻 量 级 的 通信 介质 ， 后 面 跟着 可 能 解决 无 序 或 丢 包 问题 的 实时 应 用 程序 。 该 类 
连接 不 维护 开放 的 连接 。 如 果 需 要 的 话 ， 会 将 包 发 送 到 目标 协议 地 址 。 因 为 没有 连接 ， 在 
传输 过 程 中 可 能 出 现 丢 包 或 无 序 的 情况 ， 该 协议 不 提供 处 理 这 种 情况 的 任何 服务 ， 本 章 将 
继续 修改 示例 应 用 程序 一 一 Echo， 使 其 包含 UDP 服务 器 和 客户 端的 原生 实现 。 


9.1 将 UDP Server 方法 添加 到 Echo Server Activity 中 


为 了 用 基于 UDP 的 Echo server 进行 实验 , 需要 修改 EchoServerActivity 使 其 包含 新 的 
原生 方法 ， 如 程序 清单 9-1 所 示 。 


程序 清单 9-1 nativeStartUdpServer 方法 添加 


public class EchoServerActivity extends AbstractEchoActivity { 


/x* 


* 在 给 定 端口 上 启动 UDP 服务 . 
* 


* @param port 

* 端口 号 . 

* @throws Exception 

Sf 

private native void nativeStartUdpServer (int port) throws Exception; 
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/**# 
* 服务 器 端 任务 . 


private class ServerTask extends AbstractEchoTask { 


protected void onBackground() { 
logMessage ("Starting server."); 


try { 
nativeStartUdpServer (port); 
} catch (Exception e) { 
logMessage (e.getMessage ()); 
} 


logMessage ("Server terminated."); 


} 
现在 需要 在 Echo.cpp 原生 源 文件 中 实现 该 方法 。 


9.2 ”实现 原生 UDP Server 


在 Project Explorer 中 选择 EchoServerActivity, 再 在 External Tools 菜单 中 选择 Generate 
C and C++ Header File 以 更 新 生成 的 原生 头 文件 。 


9.2.1 创建 UDP Socket: socket 


可 以 用 同一 个 socket 函数 创建 使 用 UDP 协议 的 socket, 这 通过 让 函数 创建 数据 报 socket 
而 不 是 流 socket 来 实现 。 为 了 能 够 同时 用 两 种 类 型 的 连接 进行 实验 ， 不 要 修改 已 有 的 辅助 
函数 , 而 是 要 定义 一 个 新 的 原生 函数 以 创建 UDP socket。 在 Editor 视图 中 ,将 NewUdpSocket 
辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 9-2 所 示 。 


程序 清单 9-2 NewUdpSocket 原生 辅助 函数 
/**# 

* 构造 一 个 新 的 UDP socket. 

和 

* @param env JNIEnv interface. 

* Q@param obj object instance. 

* @return socket descriptor. 

* Qthrows IOException 

be 

static int NewUdpSocket (JNIEnv* env, jobject obj) 
{ 
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// 构造 socket 
LogMessage (env, obj, "Constructing a new UDP socket...")7 
int udpSocket = socket (PF INET, SOCK DGRAM, 0); 


// 检查 socekt 构造 是 否 正 确 
if (-1 == udpSocket) 
{ 
// 抛 出 带 错 误 号 的 异常 
ThrowErrnoException(env, "java/io/IOException", errno); 


} 


return udpSocket; 


} 

NewUdpSocket 是 一 个 创建 新 数据 报 socket 并 返回 socket 描述 符 的 简单 函数 。 创 建 socket 
出 错时 ，socket 函数 将 返回 -1 且 全 局 变量 ermo 被 设置 成 相应 的 错误 码 。NewUdpSocket 函 
数 抛 出 一 个 显示 与 错误 码 相 对 应 的 错误 信息 的 IOException, 一 旦 socket 创建 成 功 , 可 以 用 
于 发 送 和 接收 数据 报 。 


9.2.2 ”从 Socket 接收 数据 报 : recvfrom 


用 recvfrom 函数 而 不 是 之 前 用 过 的 recv 函数 实现 从 UDP socket 中 接收 数据 。 


ssize t recvfroml(int socketDescriptor, void* buffer, size t bufferLength, 
int flags, struct sockaddr* address, socklen t* addressLength); 


与 recv 函数 一 样 ，recvfrom 函数 也 是 一 个 阻塞 函数 。 如 果 没 从 给 定 的 socket 接收 到 数 
据 ， 它 会 使 调用 进程 进入 挂 起 状态 , 直到 接收 到 可 用 数据 。 为 了 接受 即将 到 来 的 输入 连接 ， 
recvfrom 函数 需要 提供 以 下 参数 : 

Socket descriptor: 指定 应 用 程序 想 要 从 中 接收 数据 的 socket 实例 。 

e buffer pointer: 指向 内 存 地 址 的 指针 ， 该 内 存 用 来 保存 从 socket 接收 的 数据 。 

e buffer length: 指定 缓冲 区 的 大 小 ，recvfrom 函数 只 会 向 缓冲 区 中 写 入 该 参数 指定 
大 小 的 内 容 然后 返回 。 

e flags: 指定 接收 所 需要 的 额外 标志 。 

e。 Address pointer: 指定 一 个 地 址 结构 ， 用 于 保存 客户 端 发 送 包 的 协议 地 址 。 如 果 应 
用 程序 不 需要 该 信息 ， 将 该 参数 置 为 NULL。 

e Address length pointer: 指定 客户 端 要 写 入 的 协议 地 址 的 内 存 空间 大 小 ， 如 果 应 用 

程序 不 需要 该 信息 ， 将 该 参数 置 为 NULL。 

如 果 recvfrom 函数 成 功 , 将 返回 从 socket 处 接收 到 的 字 节 数 ; 否则 返回 -1 且 全 局 变量 
errno 将 被 设置 为 相应 的 错误 。 如 果 该 函数 返回 零 , 表示 socket 连接 失败 。 在 Editor 视图 中 ， 
将 ReceiveDatagramFromSocket 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清 
单 9-3 所 示 。 
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程序 清单 9-3 ”ReceiveDatagramFromSocket 原生 辅助 函数 


/妇女 


从 socket 中 阻塞 并 接收 数据 报 保存 到 缓冲 区 ， 填 充 客户 端 地 址 


# 
大 
* Qparam env JNIEnv interface. 

* @param obj object instance. 

* @param sd socket descriptor. 

* @param address client address. 
* Q@param buffer data buffer. 

* @param bufferSize buffer size. 
* @return receive size. 

* @throws IOException 


static ssize t ReceiveDatagramFromSocket( 
JNIEnv* env, 
jobject obj, 
int sd, 
struct sockaddr in* address, 
char* buffer, 
size t bufferSize) 


socklen t addressLength = sizeof(struct sockaddr in); 


// 从 socket 中 接收 数据 报 
LogMessage (env, obj, "Receiving from the socket..."); 
ssize t recvSize = recvfrom(sd, buffer, buffersize, 0, 
(struct sockaddr*) address, 
&addressLength); 


// 如 果 接 收 失败 
if (-1 == recvSize) 
{ 
// 抛 出 带 错误 号 的 异常 
ThrowErrnoException(env, "java/io/IOException", errno); 
} 
else 
{ 
// 记录 地 址 


LogAddress (env, obj, "Received from", address); 


// 以 NULL 终止 缓冲 区 使 其 为 一 个 字符 串 
buffer[recvSize] = NULL; 


// 如 果 数 据 已 经 接收 
if (recVSize > 0) 
{ 
LogMessage (env, obj, "Received %d bytes: %s", 
recvSize, buffer); 
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} 


EE 


} 


return recvSize; 


ReceiveDatagramFromSocket 函数 用 recvfrom 函数 从 给 定 的 socket 接收 数据 报 ， 并 将 
接收 的 数据 写 入 提供 的 数据 缓冲 区 ， 出 错时 则 抛 出 一 个 IOException 异常 ， 其 中 显示 相应 
的 错误 信息 。 发 送 数 据 报 的 方式 与 此 类 似 。 


9.2.3 ”向 Socket 发 送 数 据 报 : sendto 


与 recvfrom 函数 一 样 ， 给 UDP socket 发 送 数 据 也 是 通过 sendto 函数 而 不 是 send 函数 


ssize t sendto (int socketDescriptor, const void* buffer, size t buffersize, 
int flags, const struct sockaddr* address, socklen t addressLength); 

与 send 函数 一 样 ，sendto 函数 也 是 一 个 阻塞 函数 。 如 果 socket 在 忙 着 发 送 数据 ， 它 会 
使 调用 进程 进入 挂 起 状态 直到 socket 可 以 传输 数据 。 为 了 接收 即将 输入 的 连接 ，sendto 函 
数 需 要 提供 以 下 参数 : 


socket descriptor: 指定 应 用 程序 想 要 向 其 发 送 数 据 的 socket 实例 。 

buffer pointer: 指向 内 存 地 址 的 buffer 指针 ， 该 内 存 是 给 定 的 socket 发 送 数据 的 目 
的 地 。 

buffer length: 指定 缓冲 区 的 大 小 。sendto 函数 只 会 向 缓冲 区 传输 该 参数 所 指定 大 
小 的 数据 然后 返回 。 

flags: 指定 发 送 所 需要 的 额外 标志 。 

Address: 指定 目标 服务 器 的 协议 地 址 。 

Address length: 是 传递 给 函数 的 协议 地 址 结构 的 大 小 。 


如 果 发 送 操作 成 功 ，sendto 函数 会 返回 传送 的 字 节 数 。 否 则 返回 -1 且 全 局 变量 errno 将 
被 设置 为 相应 的 错误 。 与 recv 函数 一 样 ， 如 果 该 函数 返回 零 ， 表 示 socket 连接 失败 。 在 
Editor 视图 中 ,将 SendDatagramToSocket 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 
程序 清单 9-4 所 示 。 


程序 清单 9-4 SendDatagramToSocket 原生 辅助 函数 


/太太 


大 


LC 和 全 全 


用 给 定 的 socket 发 送 数据 报到 给 定 的 地 址 . 


Q@param env JNIEnv interface. 
Q@param obj object instance. 
Q@param sd socket descriptor. 
eparam address remote address. 
param buffer data buffer. 
@param bufferSize buffer size. 
@return sent size. 
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* @throws IOException 

i 

static ssize t SendDatagramToSocket( 
JNIEnv* env, 
jobject obj, 
int sd, 
const struct sockaddr in* address, 
const char* buffer, 
size t bufferSize) 


// 向 socket 发 送 数据 缓冲 区 
LogAddress (env, obj, "Sending to", address); 
ssize t sentSize = sendtol(sd, buffer, buffersize, 0, 
(const sockaddr*) address, 
sizeof (struct sockaddr in)); 


// 如 果 发 送 失 败 
if (-1 == SentSize) 
{ 
// 抛 出 带 错误 号 的 异常 


ThrowErrnoException (env，"java/io/IOException"，errno) 7 


} 


else if (sentSize > 0) 


LogMessage (env, obj, "Sent %d bytes: %s"， sentSize, buffer); 


} 


return sentSize; 
} 
SendDatagramToSocket 函数 用 sendto 函数 发 送 数 据 ， 用 给 定 的 socket 以 数据 报 的 形式 
发 送 数据 缓冲 区 。 实 现 这 些 辅助 函数 后 ， 可 以 开始 实现 UDP 服务 器 函数 了 。 


9.2.4 原生 UDP Server 方法 


nativeStartUdpServer 用 这 些 方法 提供 基于 UDP 的 Echo 服务 器 。 在 Editor 视图 中 ， 将 
nativeStartUdpServer 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 9-5 所 示 。 


程序 清单 9-5 ”nativeStartUdpServer 原生 方法 


void Java_com_apress_echo_EchoSerVverRActivity _ nativeStartUdpServVer( 
UNIEnVx* env, 
jobject obj, 
jint port) 


// 构造 一 个 新 的 UDP socket. 

int serverSocket = NewUdpSocket (env, obj); 
if (NULL == env->ExceptionOccurred()) 

{ 
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// 将 socket 绑 定 到 某 一 端口 号 
BindSocketToPort (env, obj, serverSocket, (unsigned short) port); 
if (NULL != env->ExceptionOccurred()) 

goto exit; 


// 如 果 请 求 随机 端口 号 

if (0 == port) 

{ 
// 获取 当前 绑 定 的 端口 号 socket 
GetSocketPort (env, obj, serverSocket); 
if (NULL != env->ExceptionOccurred()) 

goto exit; 
} 


// 客户 端 地 址 
struct sockaddr in address; 
memset (&address, 0, sizeof (address)); 


char buffer[MAX BUFFER SIZE]; 
ssize t recvSize; 
ssize t sentSize; 


// 从 socket 中 接收 
recvSize = ReceiveDatagramFromSocket (env, obj, serverSocket, 
&address, buffer, MAX BUFFER SIZE); 


if ((0 == recvSize) || (NULL != env->ExceptionOccurred())) 
goto exit; 


// 发 送 给 socket 
sentSize = SendDatagramToSocket (env, obj, serverSocket, 
&address, buffer, (size t) recvSize); 


} 


exit: 
if (serverSocket > 0) 
{ 
close (serverSocket); 
} 
} 


因为 基于 UDP 的 服务 器 是 无 连接 的 ， 所 以 既 不 需要 监听 函数 ， 也 不 需要 接收 函数 。 


9.3 将 原生 UDP Client 方法 加 入 Echo Client Activity 中 


为 了 用 基于 UDP 的 Echo 客户 端 进行 实验 ， 需 要 修改 EchoClientActivity 使 其 包含 一 
个 新 的 原生 方法 ， 如 程序 清单 9-6 所 示 。 
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程序 清单 9-6 ”添加 的 nativeStartUdpClient 方 法 


public class EchoClientActivity extends AbstractEchoActivity { 


/rx 


用 给 定 的 服务 器 端 IP 地 址 和 端口 号 启动 UDP 客户 端 . 


eparam ip 

IP 地 址 

@param port 

* 端口 号 

* @param message 

* 消息 文本 

* @throws Exception 

Private native void nativeStartUdpClient (String ip, int port, 
String message) 


洒洒 


throws Exception; 


/** 
* 客户 端 任务 . 
private class ClientTask extends AbstractEchoTask { 


protected void onBackground() { 
logMessage ("Starting client."); 


try { 

nativeSstartUdpClient (ip, port, message); 
} catch (Throwable e) { 

logMessage (e.getMessage ()); 
} 


logMessage ("Client terminated."); 


} 

在 将 原生 方法 声明 加 入 ClientTask 之 后 ， 编 译 应 用 程序 项 目 生 成 类 文件 ， 现 在 我 们 完 
成 了 该 函数 的 原生 实现 。 
9.4 实现 原生 UDP Client 

在 Project Explorer 中 选择 EchoClientActivity， 然 后 在 extemal tools 菜单 中 选择 Generate 


C and C++ Header File 以 更 新 生成 的 原生 头 文件 。 
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原生 UDP Client 方法 


在 Editor 视图 中 ,将 nativeStartUdpClient 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 
如 程序 清单 9-7 所 示 。 


程序 清单 9-7 nativeStartUdpClient 原生 方法 


void Java com apress echo EchoClientActivity nativestartUdpClient( 
JNIEnv* env, 
jobject obj, 
jstring ip, 
jint port, 
jstring message) 


// 构造 一 个 新 的 UDP socket. 
int clientSocket = NewUdpSocket (env, obj); 
if (NULL == env->ExceptionOccurred()) 


struct sockaddr in address; 


memset (&address, 0, sizeof (address)); 
adqdress.sin family = PF_INET; 


// 以 c 字符 串 形式 获取 IP 地 址 
const char* ipAddress = env->GetStringUTFChars (ip, NULL); 
if (NULL == ipAddress) 

goto exit; 


// 将 IP 地 址 字符 串 转换 为 网 络 地 址 


int result = inet aton(ipAddress, &(address.sin addr)); 


// 释放 IP 地 址 
env->ReleaseSstringUTFChars (ip, ipAddress); 


// 如 果 转 换 失 败 

if (0 == result) 

{ 
// 抛 出 带 错误 号 的 异常 
ThrowErrnoException (env, "java/io/IOException", errno); 
goto exit; 


} 
// 将 端口 转换 为 网 络 字 节 顺序 


address.sin _ port = htons (Port) 7 


// 以 c 字符 串 形式 获取 消息 
Const char* messageText = env->GetSstringUTFChars (message, NULL); 
if (NULL == messageText) 

goto exit; 
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// 获取 消息 大 小 


jsize messageSize = env->GetStringUTELength (message) 7 


// 发 送 消息 给 socket 
SendDatagramToSocket (env, obj, clientSocket, &address, 
messageText, messageSize); 


// 释放 消息 文本 


env->ReleaseStringUTFChars (message, messageText); 


// 如 果 发 送 未 成 功 
if (NULL != env->ExceptionOccurred()) 
goto exit; 


char buffer[MAX BUFFER SIZE]; 


// 清除 地 址 


memset (&address, 0, sizeof (address)); 


// 从 socket 接收 
ReceiveDatagramFromSocket (env, obj, clientSocket, &address, 
buffer, MAX BUFFER SIZE); 
t 


exit: 
if (clientSocket > 0) 
1 
close (clientSocket); 
, 
通过 创建 一 个 新 的 UDP socket 来 启动 nativeStartUdpServer 函数 。 然 后 将 给 定 的 消息 
文本 作为 数据 报 发 送 到 给 定 的 瑟 地 址 和 端口 号 。 在 发 送 数据 报时 ， 开 始 等 待 接收 响 应 的 
数据 报 。 


9.5 运行 UDP Sockets 示例 


Echo UDP 服务 器 和 客户 端 可 以 用 与 Echo TCP 服务 器 和 客户 端 同样 的 方式 测试 ， 服 务 
器 和 客户 端 均 运 行 在 两 个 不 同 的 Android Emulator 实例 上 。 启 动 每 一 个 Echo UDP 服务 器 
时 都 要 将 端口 号 设置 为 0， 一旦 UDP 服务 器 启动 ， 立 即 记 录 分 配 的 端口 号 。 


9.5.1 连通 UDP 的 模拟 器 


为 了 给 UDP 端口 设置 端口 转发 ， 需 要 使 用 Android Emulator 控制 台 。 
(1) 首先 通过 查看 windows 标题 确定 Android Emulator 实例 的 控制 台 端 口号 ， 注 意 是 
显示 在 标题 栏 上 的 四 位 数字 ， 例 如 : 5556。 
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(2) 用 你 喜欢 的 telnet 客户 端 ， 连 接 原 生 主机 及 你 在 步骤 (D) 记 下 的 端口 号 。 
(3) Android Emulator 控制 台 上 调用 下 列 命令 ， 用 每 个 UDP Server 的 端口 号 替换 <port 
number>， 设 置 UDP 端口 重 定向 。 


redir add udp:<port number>:<port number> 

注意 : 

如 果 你 正在 使 用 防火 墙 应 用 程序 ， 请 确保 通过 防火 墙 的 端口 号 是 开放 的 ， 以 接收 输入 
的 包 。 

这 会 将 Android Emulator 上 的 UDP 端口 <port number> 映 射 到 主机 上 的 UDP 端口 <port 
number>。 任何 输入 到 主机 上 <port number> 所 指定 端口 的 连接 都 会 转发 到 Android Emulator 
的 <port number> 指 定 端口 上 。 端 口 转发 是 一 种 运行 时 设置 ， 一 旦 Android Emulator 停止， 
它 将 会 被 清除 。 


9.5.2 启动 Echo UDP Client 


用 与 配置 Echo TCP Client 相同 的 参数 集 配置 Echo UDP client， 然 后 单 击 Start Client 
按钮 。 单 击 Start Client 按钮 后 , Echo UDP 客户 端 会 发 送 消息 负载 。 客户 端 和 服务 器 activity 
都 会 显示 socket 事件 以 及 被 传输 的 消息 ， 如 图 9-1 所 示 。 


© Echo client 


10.0.2.2 
46661 


test 


Start Client 


lStarting client. 
onstructing a new UDP socket... 


Receiving from the socket... 


9-1 Echo UDP 客户 端 交 换 消息 


9.6 小 结 


本 章 探讨 了 无 连接 通信 的 POSIX Socket APIs ,学 习 了 使 用 UDP 协议 的 client 和 server 
模式 ， 有 了 本 章 以 及 第 8 章 所 展示 的 核心 概念 做 基础 ， 可 以 虚拟 地 实现 网 络 上 提供 的 各 种 
服务 原生 空间 通信 协议 。 第 10 章 将 演示 如 何 用 POSIX Socket API 在 设备 的 两 个 应 用 程序 
之 间 建 立 通信 通道 。 
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POSIX Socket API: 本 地 通信 


前 两 章 我 们 学 习 了 使 用 POSIX Socket APIs 实现 远程 通信 。POSIX Socket APIs 也 可 用 
于 在 同一 设备 上 的 两 个 应 用 程序 之 间或 者 原生 代码 与 Java 层 之 间 建 立 本 地 通信 通道 。 本章 
将 继续 在 示例 应 用 程序 一 一 Echo 上 构建 。 本 地 Socket 通信 示例 将 讲解 以 下 内 容 : 

e 在 原生 层 实现 本 地 socket 服务 器 

e 在 Java 层 实现 本 地 客户 端 

。 在 两 个 应 用 程序 之 间 建 立 本 地 socket 通信 


10.1 Echo Local Activity 布局 


在 Project Explorer 视图 中 ， 展 开 resources 下 的 res 目录。 展开 layout 子 目 录 ， 创 建 一 
个 名 为 activity_echo_local.xml 的 新 布局 文件 。 在 Editor 视图 中 , 用 程序 清单 10-1 所 示 内 容 
替换 文件 原来 的 内 容 。 


程序 清单 10-1 res/layout/activity_echo_local.xml 文件 的 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<EditText 
android:id="@+id/port edit" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:hint="@string/local port edit" > 


<requestFocus /> 
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</EditText> 


<EditText 
android:id="@+id/message edit" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:hint="@string/message edit" /> 


<Button 
android:id="@+id/start button" 
androil ayout width="wrap content" 
android:layout height="wrap_ content" 


android:text="@string/start client button" /> 


<SscrollView 

android:id="@+id/log scroll™ 
:layout width="match parent" 
:layout height="0dip" 
:layout weight="1.0" > 


<TextView 
android:id="@+id/log view" 
android:layout width="match Parent" 
android:layout height="wrap content" /> 
</ScrollView> 


</LinearLayout> 


Echo Local 提供 了 一 个 简单 的 用 户 界面 以 获取 绑 定 本 地 socket 的 端口 名 、 要 发 送 的 消 
息 和 运行 时 在 原生 本 地 socket 服务 器 和 客户 端 上 显示 状态 更 新 信息 。 


10.2 Echo Local Activity 


如 前 所 述 , 打开 Project Explorer 视图 , 在 src 目录 下 新 建 一 个 名 为 LocalSocketActivityjava 
的 类 文件 。 在 Editor 视图 中 ， 添 加 程序 清单 10-2 所 示 的 内 容 。 
程序 清单 10-2 ”LocalSocketActivityjava 文件 


package com.apress .echoy 


import java.io.File; 

import java.io.InputStream7 
import java.io.OutputStream7 
import java.nio.charset.Charset; 


import android.net.LocalSocket; 
import android.net.LocalSocketAddress; 
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import android.os.Bundle; 
import android.widget.EditText; 


/** 
* Echo 本 地 socket 服务 器 和 客户 端 . 
娘 
* @author Onur Cinar 
$F 
public class LocalEchoActivity extends AbstractEchoActivity { 
/** 消息 编辑 . */ 


private EditText messageEdit; 


/太太 
* 构造 函数 . 
SF 
public LocalEchoActivity() { 
super (R.layout .activity local echo); 


public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 7 


messageEdit = (EditText) findViewById(R.id.message edit); 


protected void onstartButtonClicked() { 
String name = PortEdit.getText() .tostring(); 
String message = messageEdit.getText() .tostring(); 


if ((name.length() > 0) && (message.length() > 0)) { 
String socketName; 


// 如 果 是 filesystem socket， 预 先 准 备 应 用 程序 的 文件 目录 
if (isFilesystemSocket (name)) { 
File file = new File(getFilesDir(), name); 
socketName = file.getAbsolutePath(); 
} else { 
socketName = name; 
} 
ServerTask serverTask = new ServerTask (socketName); 
serverTask.start (); 


ClientTask clientTask = new ClientTask(socketName, message); 
clientTask.start (); 


/太太 


* 检查 名 称 是 否 是 filesystem socket. 


大 
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* @param name 
* socket 名 称 . 
* @return filesystem socket. 
a 
private boolean isFilesystemSocket (String name) { 
return name.startsWith("/"); 


. 大 
启动 绑 定 到 给 定名 称 的 本 地 UNIX socket 服务 器 。 


* @param name 

* socket 名 称 . 

* @throws Exception 

private native void nativestartLocalServer (String name) 
throws Exception; 


Fg 
启动 本 地 UNIX socket 客户 端 。 


Q@param port 
端口 号 . 

param message 
消息 文本 . 


Qthrows Exception 


站 鸡 对 并 半 并 并 并 站 


ws 


private void startLocalClient (String name, String message) 
throws Exception { 
// 构造 一 个 本 地 socket 
LocalSocket clientSocket = new LocalSocket (); 
try { 
// 设置 socket 名 称 空间 
LocalSocketAddress.Namespace namespace; 
if (isFilesystemSocket (name)) { 
namespace = LocalSocketAddress.Namespace.FILESYSTEM; 
} else { 
namespace = LocalSocketAddress.Namespace.ABSTRACT; 
1 
// 构造 本 地 socket 地 址 
LocalSocketAddress address = new LocalSocketAddress!( 
name, namespace); 


// 连接 到 本 地 socket 

logMessage ("Connecting to " + name); 
clientSocket.connect (address); 
logMessage ("Connected."); 

// 以 字 节 形式 获取 消息 


byte[] messageBytes = message.getBytes(); 
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// 发 送 消息 字 节 到 socket 

logMessage ("Sending to the socket...")7 

OutputStream outputStream = clientSocket.getOutputstream(); 

outputStream.write (messageBytes); 

logMessage (String.format ("Sent %d bytes: %s", 
messageBytes.length, message)); 


// 从 socket 中 接收 消息 返回 

logMessage ("Receiving from the socket..."); 

InputStream inputStream = clientSocket.getInputstream(); 
int readSize = inputStream.read (messageBytes); 


String receivedMessage = new String (messageBytes, 
0, readsize); 

logMessage (String.format ("Received %d bytes: %s", 
readSize, receivedMessage)); 


// 关闭 流 
outputstream.close(); 
inputstream.close (); 


} finally { 
// 关闭 本 地 socket 


clientSsocket.close(); 


/** 

* 服务 器 任务 . 

WF 

private class ServerTask extends AbstractEchoTask { 
/** Socket 名 称 . */ 
private final String name; 


/**#* 

* 构造 函数 . 

大 

* @param name 

* socket 名 称 . 

public ServerTask (String name) { 
this.name = name; 


protected void onBackground() { 
logMessage ("Starting server."); 
try { 


nativeSstartLocalServer (name); 
} catch (Exception e) { 
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logMessage (e.getMessage ()); 
. 


logMessage ("Server terminated."); 


} 


/** 
* 客户 端 任务 . 
ad 
private class ClientTask extends Thread { 
/** Socket 名 称 . */ 
private final String name; 


/** 发 送 的 消息 文本 . */ 


private final String message; 


/** 
* 构造 函数 。 
六 
* @parma name socket name . 
* @param message 
* 发 送 的 消息 文本 . 
二 
public ClientTask (String name, String message) { 
this.name = name; 
this.message = message; 


) 


public void run() { 
logMessage ("Starting client."); 


try { 

startLocalClient (name, message); 
} catch (Exception e) { 

logMessage (e.getMessage ()); 
. 


logMessage ("Client terminated."); 


} 


LocalEchoActivity activity 获取 了 本 地 socket 端口 、 来 自 UI 的 测试 消息 并 创建 了 两 个 
背景 任务 。 第 一 个 任务 运行 创建 本 地 服务 器 socket 并 等 待 连接 的 本 地 nativeStartLocalServer 
方法 ， 第 二 个 任务 运行 用 基于 Java 的 socket API 创建 的 、 用 于 实现 本 地 socket 客户 端 与 本 
地 socket 服务 器 通信 的 startLocalClient Java 方法 。 与 其 他 示例 一 样 ， 与 服务 器 socket 连接 
后 ， 客 户 端 发 送 测试 消息 并 等 待 服务 器 回 显 测试 消息 。 
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10.3 ”实现 原生 本 地 Socket Server 


在 Project Explorer 中 ， 选 择 LocalSocketActivty， 然 后 在 External Tools 菜单 中 选择 
Generate C and C++ Header File 以 生成 原生 头 文件 。 打开 Project Explorer, 展开 jni 子 目录 ， 
然后 在 编辑 器 中 打开 Echo.cpp 源 文件 ， 将 程序 清单 10-3 所 示 内 容 插入 文件 头 。 


程序 清单 10-3 ”包含 LocalSocketActivity 头 文件 


#include "com apress echo LocalEchoActivity.h" 


头 文件 包含 nativeStartLocalServer 原生 方法 声明 。 为 了 便于 该 原生 方法 的 实现 ， 需 要 
先 实 现 辅助 函数 集合 。 


10.3.1 创建 本 地 Socket: socket 


用 同一 个 socket 函数 创建 本 地 socket， 这 通过 调用 创建 PE LOCAL 协议 族 中 的 socket 
的 函数 来 实现 。 为 了 能 够 同时 用 所 有 类 型 的 连接 进行 实验 , 不 要 修改 已 有 的 原生 辅助 函数 ， 
相反 , 而 是 要 定义 一 个 新 的 原生 函数 以 创建 本 地 socket。 在 Editor 视图 中 , 将 NewLocalSocket 
辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 10-4 所 示 。 


程序 清单 10-4 ”NewLocalSocket 原生 辅助 函数 


/** 
* 构造 一 个 新 的 原生 UNIX socket. 


* @param env JNIEnv interface. 

* Q@param obj object instance. 

* @return socket descriptor. 

* Qthrows IOException 

2 

static int NewLocalSocket (JNIEnv* env, jobject obj) 

{ 
// 构造 socket 
LogMessage (env, obj, "Constructing a new Local UNIX socket..."); 
int localSocket = socket (PF LOCAL, SOCK_ STREAM, 0); 
// 检查 socket 构造 是 否 正 确 
if (-1 == localSocket) 


// 抛 出 带 错误 号 的 异常 


ThrowErrnoException(env, "java/io/IOException", errno); 


} 


return localSocket; 


} 


本 地 socket 族 既 支持 基于 流 的 socket 协议 , 也 支持 基于 数据 报 的 socket 协议 。 本 例 使 
用 基于 流 的 协议 。 
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10.3.2 ”将 本 地 socket 与 Name 绑 定 : bind 


与 TCP 及 UDP sockets 相同 ， 一 旦 创建 就 不 再 需要 分 配 协议 地 址 ， 本 地 socket 就 在 其 
socket 族 空间 中 存在 。 可 以 用 同一 个 bind 函数 将 本 地 socket 与 客户 端 用 来 连接 的 本 地 socket 
名 绑 定 ， 通 过 sockaddr un 结构 指定 本 地 socket 的 协议 地 址 ， 如 程序 清单 10-5 所 示 。 


程序 清单 10-5 ”sockaddr_un 地 址 结构 体 


struct sockaddr un { 

sa family t sun family; 

char sun path[UNIX PATH MAX]; 
}; 


local socket 协议 地 址 只 由 一 个 名 字 构 成 。 它 没有 了 P 地 址 或 者 端口 号 ， 可 以 在 两 个 不 
同 的 命名 空间 中 创建 本 地 socket 名 。 
e Abstract namespace: 在 本 地 socket 通信 协议 模块 中 维护 ，socket 名 以 NULL 字符 
为 前 缀 以 绑 定 socket 名 。 
e@ Filesystem namespace: 通过 文件 系统 以 一 个 特殊 socket 文件 的 形式 维护 ，socket 
名 直接 传递 给 sockaddr un 结构 ， 将 socket 名 与 socket 绑 定 。 
在 Editor 视图 中 ,将 BindLocalSocketToName 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文 
件 中 ， 如 程序 清单 10-6 所 示 。 


程序 清单 10-6 ”BindLocalSocketToName 原生 辅助 函数 


AAA 
* 将 本 地 UNIX socket 与 某 一 名 称 绑 定 


太 
* @param env JNIEnv interface. 
* @param obj object instance. 
* @param sd socket descriptor. 
* @param name socket name. 
* @throws IOException 
Wid 
static void BindLocalSocketToName ( 
JNIEnv* env, 
jobject obj, 
int sd, 
const char* name) 


struct sockaddr un address; 


// 名 字 长 度 


const size 七 nameLength = strlen (name) 


// 路 径 长 度 初始 化 与 名 称 长 度 相等 


size t pathLength = nameLength; 


// 如 果 名 字 不 是 以 /开头 ， 即 它 在 抽象 命名 空间 里 
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// in the abstract namespace 
bool abstractNamespace = ('/" != name[0]); 


// 抽象 命名 空间 要 求 目 录 的 第 一 个 字 节 是 0 字 节 ， 更 新 路 径 长 度 包 括 0 字 节 
if (abstractNamespace) 
{ 
pathLength++; 
} 


// 检查 路 径 长 度 
if (pathLength > sizeof (address.sun path)) 
和 
// 抛 出 带 错误 号 的 异常 
ThrowException (env, "java/io/IOException", "Name is too big."); 
} 
else 
{ 
// 清除 地 址 字 节 


memset (&address, 0, sizeof (address)); 
address.sun family = PE LOCAL; 


// Socket 路 径 
char* sunPath = address.sun path; 


// 第 一 字 节 必须 是 0 以 使 用 抽象 命名 空间 
if (abstractNamespace) 


{ 
*sunPath++ = NULL; 


’ 
// 追加 本 地 名 字 


strcpy (sunPath, name); 


// 地 址 长 度 

socklen t addressLength = 
(offsetof(struct sockaddr un, sun path)) 
+ pathLength; 


// 如 果 socket 名 已 经 绑 定 ， 取 消 连 接 


unlink (address.sun path) 7 


// 绑 定 socket 

LogMessage (env, obj, "Binding to local name %s%s.", 
(abstractNamespace) ? "(nu11)"™ : "", 
name); 


if (-1 == bind(sd, (struct sockaddr*) &address, addressLength)) 
! 
// 抛 出 带 错误 号 的 异常 


ThrowErrnoException (env, "java/io/IOException", errno); 
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BindLocalSocketToName 原生 函数 将 给 定 的 本 地 socket 与 给 定 的 本 地 socket 名 绑 定 。 
它 检查 本 地 socket 名 是 否 以 斜 线 开头 以 确定 所 使 用 的 命名 空间 是 abstract 命名 空间 还 是 文 
件 系 统 命名 空间 。 一 旦 本 地 socket 与 本 地 socket 名 绑 定 ， 应 用 程序 可 能 开始 等 待 并 接收 即 
将 到 来 的 本 地 连接 。 


10.3.3 接受 本 地 Socket: accept 


用 同一 个 接收 函数 接收 本 地 socket 的 输入 连接 ， 唯 一 的 区 别 是 由 接收 函数 返回 的 客户 
端 协议 地 址 是 socketaddr_ un 类 型 的 。 在 Editor 视图 中 ， 将 AcceptOnLocalSocket 辅助 函数 
追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 10-7 所 示 。 


程序 清单 10-7 AcceptOnLocalSocket 原生 辅助 函数 


J 
* 阻塞 并 等 待 给 定 socket 上 即将 到 来 的 客户 端 连 接 . 


* @param env JNIEnv interface. 
* Q@param obj object instance. 
* @param sd socket descriptor. 
* @return client socket. 
* @throws IOException 
站 
static int AcceptOnLocalSocket( 
JNIEnv* env, 
jobject obj, 
int sd) 


// 阻塞 并 等 待 即将 到 来 的 客户 端 连接 并 且 接 收 它 
LogMessage (env, obj, "Waiting for a client connection..."); 
int clientSocket = accept (sd, NULL, NULL); 


// 如 果 客 户 端 socket 无 效 
if (-1 == clientSocket) 
{ 
// 抛 出 带 错 误 号 的 异常 
ThrowErrnoException(env, "java/io/IOException", errno); 


} 


return clientSocket; 


} 
10.3.4 ”原生 本 地 Socket Server 


nativeStartLocalServer 原生 方法 与 nativeStartTcpServer 原生 方法 非常 相似 , 唯一 的 区 别 
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是 nativeStartLocalServer 使 用 本 地 socket 而 不 是 TCP socket。 在 Editor 视图 中 , 将 nativeStart- 
LocalServer 辅助 函数 追加 到 Echo.cpp 原生 模块 源 文件 中 ， 如 程序 清单 10-8 所 示 。 


程序 清单 10-8 ”nativeStartLocalServer 原生 方法 


void Java com apress echo LocalEchoActivity nativeSstartLocalServer!( 
JNIEnv* env, 
jobject obj, 
jstring name) 


// 构造 一 个 新 的 本 地 UNIX socket. 
int serverSocket = NewLocalSocket (env, obj); 
if (NULL == env->ExceptionOccurred()) 
{ 
// 以 c 字 符 串 形式 获取 名 称 
const char* nameText = env->GetStringUTFChars (name, NULL); 
if (NULL == nameText) 
goto exit; 


// 绑 定 socket 到 某 一 端口 号 


BindLocalSocketToName (env, obj, serverSocket, nameText); 


// 释放 name 文本 


env->ReleaseSstringUTFChars (name, nameText); 


// 如 果 绑 定 失败 
if (NULL != env->ExceptionOoccurred()) 
goto exit; 


// 监 听 有 4 个 挂 起 连接 的 带 backlog 的 socket 
ListenOnSocket (env, obj, serverSocket, 4); 
if (NULL != env->ExceptionOccurred()) 

goto exit; 


// 接受 socket 的 一 个 客户 连接 
int clientSocket = AcceptOnLocalSocket (env, obj, serverSocket); 
if (NULL != env->ExceptionOccurred()) 

goto exit; 


char buffer[MAX BUFFER SIZE]; 
ssize t recvSize; 
ssize t sentSize; 


// 接收 并 发 送 回 数据 
while (1) 
| 
// 从 socket 中 接收 
recvSize = ReceiveFromSocket (env, obj, clientSocket, 
buffer, MAX BUFFER SIZE); 


if ((0 == recvSsize) || (NULL != env->ExceptionOccurred()) 
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break; 


// 发 送 给 socket 


sentSize = SendToSocket (env, obj, clientSocket, 
buffer, (size t) recvSize); 


if ((0 == sentSize) || (NULL != env->ExceptionOccurred())) 
break; 


3 
// 关 闭 客户 端 socket 


close (clientSocket)7 


} 


exit: 
if (serverSocket > 0) 


{ 


close (serverSocket); 


} 
} 


nativeStartLocalServer 原生 方法 需要 使 用 之 前 定义 的 辅助 函数 , 它 创建 一 个 本 地 socket 
并 将 其 与 给 定 的 名 字 绑 定 ， 开 始 等 待 本 地 连接 并 简单 地 回 显 接收 到 的 字 节 。 本 地 socket 通 
信 应 用 程序 的 服务 器 和 客户 端 部 分 现在 都 实现 了 。 


10.4 将 本 地 Echo Activity 添加 到 Manifest 中 


Echo local activity 需要 添加 到 Android Manifest 文件 中 才能 使 用 。 在 Project Explorer 
视图 的 编辑 器 中 打开 AndroidManifestxml， 用 程序 清单 10-9 所 示 内 容 修 改 文件 内 容 。 


程序 清单 10-9 ”本 地 Echo Activity 添加 到 AndroidManifest.xml 文件 
<manifest xmlns:android="http://schemas .android.com/apk/res/android" 
Package="com.apress.echo" 
android:versionCode="1" 
android:versionName="]1.0" > 


<activity 
android:name=".LocalEchoActivity" 
android:label="@string/ title activity local echo" > 


<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 
android:name="android.intent.category .LAUNCHER" /> 


</intent-filter> 
</activity> 


</manifest> 
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10.5 ”运行 本 地 Sockets 示例 


因为 本 地 socket 实例 的 服务 器 部 分 和 客户 端 部 分 属于 同一 个 activity， 可 以 按照 以 下 
步骤 在 单个 Android 模拟 器 实例 上 测试 。 

(1) 在 Android 模拟 器 上 启动 本 地 socket activity。 

(2) 将 Socket Name 设置 成 /file 以 在 filesystem 命名 空间 中 创建 本 地 socket。 

(3) 将 Message 设置 成 将 要 传送 的 文本 。 

(4) 单 击 Start 按钮 启动 客户 端 和 服务 器 。 

显示 的 socket 事件 和 消息 如 图 10-1 所 示 。 


”4 7:17 


© Local Echo 


/file 
test 


Start Client 


tarting server. 

onstructing a new Local UNIX socket... 
inding to local name /data/data/com.apress.echo/files/file. 
istening on socket with a backlog of 4 pending connections. 
aiting for a client connection... 

tarting client. 

onnecting to /data/data/com.apress.echo/files/file 


10-1 本 地 echo 客户 端 和 服务 器 端 交换 消息 


10.6 ”异步 1O 


如 前 所 述 ， 大 多 数 socketAPIs 阻塞 函数 调用 。 这 些 函 数 挂 起 调用 进程 直到 满足 某 些 条 
件 ， 例 如 读 操 作 时 socket 上 有 可 读数 据 。socket 通过 select 函数 提供 异步 JO。 与 其 他 在 给 
定 的 时 间 内 只 能 操作 一 个 socket 描述 符 的 socket APIs 不 同 ,select 函数 可 以 操作 多 个 socket 
描述 符 并 同时 监控 它们 的 状态 。 如 果 监 控 的 一 个 事件 发 生 或 者 到 了 指定 的 时 限 ， 则 函数 阻 
塞 。 要 使 用 select 函数 ， 需 要 先 包 含 sys/select.h 头 文件 。 

#include <sys/select.h> 


select 函数 要 求 提 供 下 列 参数 : 


int select (int nfds, fqd set* readfds, fd set* writefds,fd set* exceptfds, 
struct timeval* timeout); 


e nfds: 为 最 高 编号 的 描述 符 加 1，select 函数 将 监控 nfds 指定 数量 的 描述 符 。 
。 readfds: 设置 将 被 监控 可 读 性 的 描述 符 列表 集 。 
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e writefs: 设置 将 被 监控 可 写 性 的 描述 符 列表 集 。 
e exceptfds: 设置 将 被 监控 任何 类 型 错误 的 描述 符 列表 集 。 
e timeout: 指定 为 了 完成 选择 而 阻塞 当前 进程 的 最 大 时 间 间 隔 。 如 果 不 需 要 ， 将 其 
值 设置 为 NULL。 
如 果 选 择 成 功 ，select 函数 返回 就 绪 的 描述 符 数 ， 和 否则 返回 -1， 同 时 将 ermo 设置 为 相 
应 的 错误 。 
select 函数 的 描述 符 列表 通过 fd_set 结构 提供 。 


struct fd set readfds; 


为 了 处 理 manipulate 描述 符 列表 ， 需 要 提供 下 面 的 宏 集合 : 

。 FD_ZERO 宏 : 保存 指向 乌 _set 结构 的 指针 并 清除 它 。 

e FD_SET 宏 : 保存 指向 fd_set 结构 的 指针 并 将 描述 符 添 加 到 集合 中 。 

e FD_CLR 宏 : 保存 指向 fa_set 结构 的 指针 并 从 集合 中 删除 描述 符 。 

e FD _ISSET 宏 : 可 以 在 选择 完成 后 用 来 检查 描述 符 是 否 为 选择 函数 返回 的 集合 的 一 
部 分 。 


10.7 ”小结 
本 章 探讨 了 用 于 在 同一 台 设 备 上 的 本 地 socket 通信 的 POSIX Socket APIs。 本 章 还 简要 
介绍 了 POSIX Socket API 的 异步 IO 能 力 ， 后 面 三 章 ( 包 括 本 章 ) 将 学 习 Bionic 提供 的 、 用 


于 在 原生 层 开发 网 络 应 用 程序 的 基本 概念 和 API。 学 了 这 些 内 容 ， 任 何 网 络 协议 均 可 以 很 
容易 地 在 原生 层 实现 。 
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山 


支 持 C++ 


第 10 章 已 经 探究 了 Bionic C 标准 库 提供 的 功能 ，Bionic 提供 了 与 操作 系统 以 及 硬件 
进行 交互 经 常 需要 用 到 的 一 些 基 本 结构 和 通用 的 抽象 接口 。 与 Java 框架 相 比 ，Bionic 提供 
的 通用 结构 确实 很 少 。 除 了 标准 C 库 之 外 ，C++ ISO 标准 指定 了 针对 C++ 程序 语言 的 额外 
标准 库 ， 即 大 家 熟知 的 C++ 标 准 库 。 该 库 提 供 了 诸多 泛 型 容器 、 字 符 串 、 流 以 及 日 常 需要 
的 一 些 实用 工具 函数 。 通 过 C++ 标 准 库 提供 的 搭建 积木 ， 通 过 使 开发 人 员 将 精力 集中 在 真 
正 的 程序 逻辑 上 而 不 是 开发 一 些 实现 逻辑 所 必须 的 结构 ， 简 化 了 原生 开发 过 程 。 这 使 C++ 
开发 效率 更 高 ， 并 促进 了 代码 复 用 。 

本 章 开始 探究 Android 平台 及 Android NDK 提供 的 C++ 运行 库 支持 。 本 章 着 重 讲述 以 
下 核心 内 容 : 

e 各 种 可 用 的 C++ 运行 库 
异常 以 及 RTTI 支持 的 可 用 性 
C++ 标准 库 概念 综述 
C++ 运行 库 线程 安全 
C++ 运行 库 调试 模式 


11.1 支持 的 C++ 运行 库 


Android 平台 带 有 一 个 微型 的 C++ 运行 库 支 持 库 ， 称 为 系统 运行 库 。 该 运行 库 不 支持 
以 下 特性 : 

e C++ 标 准 库 

。 异常 支持 

e。 RTTI 支持 

Android NDK 提供 了 用 于 补充 系统 运行 库 功 能 的 一 些 额外 的 C++ 运 行 库 ， 以 完善 上 述 
缺失 的 特性 。 对 这 些 C++ 运行 库 的 比较 如 表 11-1 所 示 。 
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表 11-1 支持 的 C++ 运行 库 比 较 
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11.1.1 GAbi++ C++ 运行 库 


GAbit+ C++ 运行 库 是 一 个 实验 性 的 、 最 简化 型 的 运行 库 , 它 提供 建立 在 系统 运行 库 所 
提供 的 相同 特性 集 基 础 之 上 的 RTTI 支持。 它 可 以 作为 静态 库 或 共享 库 使 用 。 


11.1.2 ”STLport C++ 运行 库 


STLport 是 一 个 开源 的 、 多 平台 的 C++ 标准 库 实 现 。 它 提供 一 个 C++ 标准 库 头 文件 的 
完整 集合 以 及 对 RTTI 的 支持 。 在 本 章 编写 时 ，Android NDK 中 的 STLport C++ 运行 库 是 基 
于 STLport 5.2.0 版 本 的 。 STLport 可 以 作为 静态 库 或 共享 库 使 用 。STLport 按 免 费 许可 证 授 
权 ， 可 用 于 商业 或 开源 项 目 中 。 


11.1.3 GNU STL C++ 运行 库 


GNU 标准 C++ 库 ， 也 叫 libstde++-v3， 是 Android NDK 中 最 全 面 的 标准 C++ 运行 库 。 
它 是 一 个 正在 开发 的 、 以 实现 ISO 标准 C++ 库 为 目标 的 开源 项 目 。 

在 GNU 标准 C++ 运行 库 中 ，C++ 异 常 与 CH+RTTI 均 被 支持 。 如 果 原 生 代码 确实 需要 
任何 一 种 特性 ， 则 需要 通过 构建 系统 变量 进行 显 式 的 声明 ， 正 如 在 本 章 的 C++ 异常 与 
C++RTTI 部 分 中 描述 的 那样 。 

在 Android NDK 中 ，GNU 标准 C++ 库 可 作为 静态 库 或 共享 库 使 用 。 与 Android NDK 
组 件 中 的 其 他 组 件 不 同 , 除了 GCC Runtime Library Exception 之 外 , 均 是 在 GNU 通用 公共 
许可 证 版 本 3(GNU GPL v3) 许 可 下 发 布 的 。 


11.2 ”指定 C++ 运行 库 


在 原生 Android 项 目 中 ，Android NDK 构建 系统 变量 APP_STL 可 被 用 于 指定 需要 
使 用 的 C++ 运行 库 。APP_STL 变量 是 一 个 应 用 级 别 的 变量 ， 仅 可 以 在 jni 子 目 录 下 的 
Application.mk 构建 文件 中 定义 ， 如 程序 清单 11-1 所 示 。 

程序 清单 11-1 选 定 C++ 运行 库 的 jni/Application.mk 文件 的 内 容 


APP ABI := armeabi armeabi-v7a 
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APP STL := System 


APP_STL 变量 仅 有 一 个 值 ， 即 所 用 的 C++ 运行 库 的 名 字 。 在 本 章 编写 时 ，APP_STL 变 
量 支持 如 下 的 值 : 
e system: 默认 的 微型 系统 C++ 运行 库 。 若 APP_STL 未 被 设置 ， 系 统 运 行 库 会 作为 
默认 值 被 使 用 。 
gabit+_static: 作为 静态 库 的 GAbit+ 运 行 库 。 
gabi++_shared: 作为 共享 库 的 GAbi++ 运 行 库 。 
stlport_static: 作为 静态 库 的 STLport 运行 库 。 
stlport_shared: 作为 共享 库 的 STLport 运行 库 。 
gnustL_static: 作为 静态 库 的 GNU STL 运行 库 。 
gnustl_shared: 作为 共享 库 的 GNU STL 运行 库 。 


11.3 ”静态 运行 库 与 动态 运行 库 


除了 系统 运行 库 外 ， 所 有 支持 的 C++ 运行 库 都 同时 提供 静态 库 和 共享 库 。 应 用 程序 开 
发 人 员 可 选择 将 他 们 的 原生 模块 与 所 需要 的 C++ 运行 库 进行 静态 或 动态 的 链接 。 

。 只 有 项 目 中 包含 单一 的 原生 模块 时 支持 静态 库 。 

e 项 目 中 包含 多 个 原生 模块 时 推荐 使 用 共享 库 。 

当 C++ 运行 库 以 共享 库 的 形式 使 用 时 ， 应 用 程序 需要 先 加 载 所 需要 的 共享 库 ， 然 后 再 
加 载 依赖 于 此 共享 库 的 其 他 原生 模块 。 需 要 以 逆序 加 载 库 文件 ， 如 程序 清单 11-2 所 示 。 


程序 清单 11-2 ” 显 式 加 载 动态 C++ 运行 共享 库 


static { 
System.loadLibrary ("strport shared"); 
System.1loadLibrary ("modulel1"); 
System.1loadLibrary ("module2"); 
} 
这 将 在 加 载 原生 模块 前 加 载 stlport_shared 共享 库 , 这 样 一 来 , 在 加 载 那 些 链接 了 C++ 
运行 库 的 模块 时 ，C++ 运 行 库 处 于 可 用 状态 。 否 则 ， 对 原生 模块 的 加 载 将 会 失败 。 


11.4 “C++ 异常 支持 


异常 就 是 当 出 现 一 个 异常 事件 时 (如 一 段 封装 的 代码 块 出 错 )， 将 程序 的 控制 权 转移 给 
被 称 为 异常 处 理 程序 的 特定 函数 的 机 制 。Android NDK 通过 GNU STL C++ 运行 库 提 供 对 
C++ 异 常 的 支持 。 为 了 在 原生 模块 中 使 用 C+ 异常 ， 需 要 按照 如 下 方式 在 Application mk 中 
指定 GNU STL: 


APP_STL := gnustl] shared 
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考虑 到 兼容 性 和 性 能 的 因素 ， 默 认 情 况 下 C++ Exception 支持 是 不 可 用 的 。 可 以 通过 
配置 Android.mk 构建 文件 中 的 LOCAL CPP FEATURES 生成 系统 变量 将 C++ Exception 
支持 设置 为 对 单个 原生 模块 可 用 。 如 程序 清单 11-3 所 示 : 

程序 清单 11-3 Android.mk 构建 文件 启用 C++ 异常 支持 的 配置 内 容 


LOCAL MODULE := module 
LOCAL CPP FEATURES += exceptions 


ei $ (BUILD SHARED LIBRARY) 

可 以 通过 配置 Application.mk 构建 文件 中 的 APP_CPPFLAGS 生成 系统 变量 将 C++ 异 
常 支持 授权 给 所 有 的 原生 模块 ， 如 程序 清单 11-4 所 示 : 

程序 清单 11-4 ”Application.mk 生成 文件 启用 C++ Exceptions 支持 的 配置 内 容 


APP_STL := gnustl shared 
APP CPPFLAGS += 一 fexceptions 


将 C++ 异常 支持 授权 给 所 有 的 原生 模块 ， 这 些 模块 只 是 应 用 程序 的 一 部 分 。 可 用 同样 
的 方式 启用 C++ RTTI 支持 。 


11.5 C++ RTTI 支持 


运行 库 类 型 信息 (Run-Time Type Information，RTTD 机 制 即 在 运行 库 展示 对 象 类 型 信 
息 。 该 机 制 主要 用 于 执行 安全 类 型 转化 。dynamic_cast、typeid 操作 符 还 有 type_info 类 是 
RTTI 的 一 部 分 。Android NDK 通过 GAbi++、STLport 或 者 GNU STL C++ 运行 库 给 RTTI 
提供 支持 。 为 了 在 原生 模块 中 使 用 RTTI， 首 先 需 要 按照 如 下 方式 在 Application.mk 中 指定 
合适 的 C++ 运行 库 。 


APP_STL := gnust1_shared 


考虑 到 兼容 性 和 性 能 ,默认 情况 下 C++ RTTI 支持 是 不 可 用 的 。 可 以 通过 配置 Androidmk 
生成 文件 中 的 LOCAL_CPP FEATURES 构建 系统 变量 将 C++ 异常 支持 授权 给 单个 原生 模 
块 。 如 程序 清单 11-5 所 示 : 


程序 清单 11-5 Android.mk 生成 文件 启用 RTTI 支持 的 配置 内 容 
LOCAL MODULE := module 

LOCAL CPP FEATURES += rtti 

ima $ (BUILD SHARED LIBRARY) 


可 以 通过 设置 Application.mk 生成 文件 中 的 APP_CPPFLAGS 生成 系统 变量 将 C++ 异 
常 支 持 启用 给 所 有 的 原生 模块 ， 如 程序 清单 11-6 所 示 : 
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程序 清单 11-6 ”Application.mk 生成 文件 启用 RTTI 支持 的 配置 内 容 


APP_ STL := gnustl] shared 
APP CPPFLAGS += —frtti 


将 C++RTTI 支持 授权 给 所 有 的 原生 模块 ， 这 些 模块 是 应 用 程序 的 一 部 分 。 


11.6 C++ 标准 库 入 门 


因为 C++ 标准 库 规 范 非常 庞大 ， 本 节 只 对 其 提供 的 功能 做 一 个 简要 的 概述 。 更 多 的 信 
息 可 以 在 各 自 的 C++ 运行 库 文档 中 找到 : 

e STLport 文档 的 地 址 为 : www.stlport.org/doc/ 

e GNUSTL 文档 的 地 址 为 : http://gcc.gnu.org/onlinedocs/libstdc++/ 


11.6.1 容器 


容器 是 一 个 对 象 ， 可 以 存放 其 他 对 象 ， 并 提供 访问 和 操作 这 些 元 素 的 方法 。 容 器 内 元 
素 的 生命 周期 不 会 超过 它 所 隶属 的 容器 的 生命 周期 。 


1. 序列 


序列 是 一 个 种 大 小 可 变 的 容器 ， 它 的 元 素 都 是 线 型 排序 的 。C++ 标 准 库 提 供 支持 以 下 
序列 容器 : 

evector 支持 随机 访问 元 素 。 它 支持 在 末尾 位 置 以 常量 时 间 插 入 和 删除 元 素 , 在 其 他 
位 置 以 线性 时 间 插入 和 删除 元 素 。 

edeque 同 vector 类 似 ， 但 除 具 备 vector 的 结构 属性 外 ， 还 支持 在 序列 开始 的 位 置 以 
常量 时 间 插 入 和 删除 元 素 。 这 使 得 deque 被 选 作 实现 队列 的 基础 。 

e list 是 一 个 双向 链表 。list 同时 支持 正 向 和 反 向 遍历 序列 。 

eslist 是 一 个 单项 链表 。slist 只 支持 正 向 遍历 序列 。 


2. 关联 容器 


关联 容器 是 一 种 大 小 可 变 的 容器 ， 它 支持 通过 键 来 高 效 地 检索 元 素 。 关 联 容器 内 的 每 
个 元 素 都 有 一 个 对 应 的 键 。 关 联 容器 主要 有 两 种 类 型 : 排序 关联 容器 和 哈 希 关联 容器 。 


排序 关联 容器 
排序 关联 容器 按照 区 分 大 小 写 升序 排序 来 存储 键 值 。 它 可 以 保证 大 多 数 操作 的 复杂 度 
绝 不 会 超过 对 数 阶 。 下 面 是 C++ 标准 库 支 持 的 排序 关联 容器 : 
e set 是 一 个 已 排序 的 简单 关联 容器 。 它 的 所 有 元 素 都 已 排序 ， 而 且 没有 任何 两 个 元 
素 是 相同 的 。 
e map 是 用 唯一 的 键 来 保存 关联 数据 的 关联 容器 。 它 使 用 键 值 与 元 素 关联 ， 没 有 任 
何 两 个 元 素 是 相同 的 。 
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e multiset 是 一 个 已 排序 的 、 简单 的 、 多重 的 关联 容器 。 它 的 所 有 元 素 都 是 已 排序 的 ， 
而 且 允 许 有 重复 的 元 素 。 

e multimap 是 一 个 已 排序 的 、 多 重 键 值 对 的 容器 。 它 使 用 键 值 与 元 素 关 联 ， 对 拥有 
相同 键 值 的 元 素数 量 不 做 限制 。 


哈 希 关联 容器 
哈 希 关联 容器 是 基于 哈 希 表 实现 的 , 它 对 存储 的 元 素 不 做 排序 。 与 排序 关联 容器 相 比 ， 
哈 希 关联 容器 的 速度 要 快 很 多 。 它 可 以 保证 大 多 数 操作 的 最 坏 时 间 复 杂 度 就 是 容器 大 小 的 
线性 操作 复杂 度 。 哈 希 关 联 容器 的 这 个 优势 使 得 它 特别 适合 快速 查询 需要 的 元 素 。 同 排序 
关联 容器 相 比 ， 哈 希 关 联 容器 不 会 对 它 所 存储 的 键 值 和 元 素 做 任何 排序 。 下 面 是 C++ 标准 
库 支 持 的 哈 希 关联 容器 : 
。 hashed set 是 一 个 简单 的 散 列 关联 容器 , 它 不 允许 存在 重复 的 元 素 。 最 适合 快速 检 
查 集合 中 的 一 个 元 素 。 
。 hash_map 是 一 个 散 列 对 关联 容器 ， 它 将 键 和 元 素 关联 ， 而 且 可 以 通过 这 些 键 对 元 
素 进行 快速 查找 。 不 管 是 键 还 是 元 素 都 没 按照 任何 规则 进行 排序 。 
。 hash_multiset 是 一 个 简单 的 散 列 多 重 关 联 容器 ， 它 允许 容器 中 出 现 出 重复 元 素 。 
同 其 他 散 列 关联 容器 一 样 ， 它 可 以 通过 键 来 查找 元 素 。 
hash_multimap 是 一 个 散 列 对 多 重 关 联 容器 。 它 将 键 和 元 素 进行 关联 而 且 提供 快速 
查找 。 它 允许 容器 中 出 现 多 个 元 素 对 应 同一 个 键 的 情况 。 


3. 适配器 


容器 适配器 用 于 在 已 有 的 基本 容器 类 型 的 基础 上 提供 专门 的 容器 类 型 。 一 般 通 过 限制 
已 有 的 容器 集合 的 功能 来 实现 专门 类 型 的 容器 。 下 面 的 容器 就 是 通过 适配器 实现 的 : 
e stack 是 一 种 后 进 先 出 (LIFO) 的 数据 结构 。 它 是 通过 适配器 限制 deque 的 功能 ， 并 
在 deque 的 一 端 实现 的 。 
。 queue 是 一 种 先进 先 出 (FIFO) 的 数据 结构 。 它 同样 是 通过 适配器 限制 deque 的 功能 ， 
并 在 deque 的 一 端 实现 的 。 


4. String 


String 同样 是 一 个 容器 类 型 ， 它 被 表示 为 一 个 字符 序列 。 除 序列 通常 使 用 的 方法 外 ， 
string 类 追加 了 标准 的 字符 串 操作 方法 ， 比 如 字符 串 串 联 和 搜索 。 通 过 这 些 类 提供 的 方法 ， 
字符 串 值 可 以 和 普通 C 字符 串 进行 互相 转换 。 


11.6.2 ”迭代 器 


和 迭代 器 可 以 对 指定 范围 内 或 一 个 容器 内 的 对 象 进行 欠 代 。 它 们 是 泛 化 的 指针 ， 但 是 它 
们 被 实现 成 为 通用 类 的 形式 。 迁 代 器 是 C++ 标准 库 的 关键 组 成 部 分 ， 因 为 它们 是 容器 之 间 
的 接口 和 算法 。C++ 标 准 库 基于 访问 权限 的 级 别 和 要 执行 的 操作 类 型 ， 提 供 了 5 种 基本 的 
迭代 器 : 
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e Input iterator: 用 来 读 取 它 所 引用 元 素 的 值 。 

e Onutput iterator: 由 于 修改 当前 位 置 对 象 的 值 。 

e@ Forward iterator: 可 以 用 于 多 种 算法 ， 因 为 它 符合 值 的 线性 序列 的 常用 概念 ， 而 且 
它 并 不 规定 输入 或 输出 操作 。 

。 Bidirectional iterator: 可 以 用 于 向 前 或 向 后 遍历 给 定 范围 的 元 素 。 

。 Random access iterator: 提供 普通 C 指针 算法 的 所 有 操作 ， 它 为 以 任意 大 小 步 幅 遍 
历 元 素 提供 常量 时 间 方 法 。 

通过 适配器 可 以 提供 这 些 迭 代 器 的 派生 迭代 器 ， 比 如 reverse iterator 和 front insert 


iterator。 
11.6.3 ”算法 


C++ 标准 库 同样 提供 了 一 套 广泛 的 常用 功能 来 操作 一 系列 的 元 素 ， 如 集合 。 对 给 定 范 
围 的 元 素 ， 算 法 提供 功能 对 其 搜索 、 蔡 换 、 复 制 和 提取 边界 。 它 们 依靠 迭代 器 作为 接口 来 
遍历 容器 。 


11.7 “C++ 运行 库 的 线程 安全 


所 有 的 C++ 运行 库 实现 都 是 线程 安全 的 ,也 就 是 说 对 共享 容器 的 同时 读 操作 时 安全 的 ， 
但 是 ， 如 果 线 程 既 需要 对 共享 容器 进行 读 操作 ， 又 需要 进行 写 操作 ， 则 应 用 程序 负责 确保 
操作 的 互 斥 性 。 


11.8 ”C++ 运行 库 调试 模式 


C++ 运行 库 的 性 能 已 经 进行 优化 ,所 以 它们 很 少 或 根本 不 执行 错误 检查 。GNU STL 和 
STLport 的 C++ 运行 库 提供 了 调试 模式 ， 使 得 检测 对 C++ 标准 库 错误 的 使 用 和 隐藏 在 应 用 
程序 代码 中 的 bug 变 得 更 容易 。 调 试 模式 用 语义 上 对 等 但 安全 的 容器 和 迭代 器 来 替换 不 安 
全 的 标准 容器 和 人 迭代 器 。 以 下 是 调试 模式 提供 的 调试 工具 : 
e Safe iterators: 追踪 和 连接 着 迭代 器 的 容器 。 它 们 会 执行 迭代 器 的 有 效 性 和 所 有 权 
的 运行 库 校 验 。 比 如 ， 向 一 个 指向 一 个 已 被 销毁 容器 的 迭代 器 取 值 ， 只 要 存在 这 
样 的 错误 ， 在 调试 模式 下 就 会 被 发 现 。 

。 Algorithm: 预 处 理 尝试 验证 输入 的 参数 。 并 且 只 要 存在 错误 就 会 被 检测 出 来 。 算 
法 预 处 理会 用 任何 有 效 的 附加 信息 又 来 验证 ， 如 迭代 器 在 容器 中 的 位 置 。 


11.8.1 GNU STL 调试 模式 


GNU STL C++ 运 行 库 允许 在 指定 的 部 分 代码 或 整个 应 用 程序 下 启动 调试 模式 。 
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1. 使 用 单独 的 GNU STL 调试 容器 


为 了 只 为 指定 的 部 分 代码 启动 调试 模式 ，GNU STL 用 ”gnu_debug 命名 空间 代替 std 


命名 空间 来 为 大 多 数 的 容器 提供 调试 模式 启动 副本 。 这 些 调 试 容器 可 以 包含 在 头 文件 名 加 
有 debug 前 级 的 子 目录 下 ， 如 程序 清单 11-7 所 示 : 


程序 清单 11-7 ”在 部 分 代码 内 启动 GNU STL 调试 模式 
// 包含 调试 vector 容器 


#include <debug/vector> 


__ gnu debug::vector V7 


使 用 单独 的 GNU STL 调试 容器 需要 修改 代码 ， 在 大 部 分 情况 下 这 不 是 最 优 的 选择 。 
GNU STL 调试 模式 同样 可 以 在 不 需要 修 该 源 代码 的 情况 下 ， 在 编译 时 启动 。 


2. 启动 GNU STL 调试 模式 


可 以 通过 预 处 理 标 识 GLIBCXX_DEBUG 来 控制 调试 模式 。 可 以 通过 APP_CFLAGS 构 
建 系统 变量 为 项 目 中 的 所 有 原生 模块 定义 该 标识 ， 也 可 以 通过 LOCAL _CFLAGS 构建 系统 
变量 为 指定 的 原生 模块 定义 该 标识 ， 如 程序 清单 11-8 所 示 。 


程序 清单 11-8 为 当前 模块 启用 GNU STL 调试 模式 
LOCRAL _ MODULE := module 


LOCAL CFLAGS += —D_GLIBCXX DEBUG 

和 $ (BUILD_ SHARED LIBRARY) 

原生 模块 会 根据 启用 或 者 禁用 调试 模式 的 情况 被 重新 编译 。 
11.8.2 ”STLport 调试 模式 

可 以 通过 预 处 理 标 识 _STLP_DEBUG 来 控制 调试 模式 。 可 以 通过 APP_CFLAGS 构建 
系统 变量 为 项 目 中 的 所 有 原生 模块 定义 该 标识 , 也 可 以 通过 LOCAL_CFLAGS 构建 系统 变 
量 为 指定 的 原生 模块 定义 该 标识 ， 如 程序 清单 11-9 所 示 。 


程序 清单 11-9 为 当前 模块 启用 STLport 调试 模式 
LOCAL MODULE := module 


LOCAL CFLAGS += —D_STLP DEBUG 
include $ (BUILD SHARED LIBRARY) 


原生 模块 需要 根据 启用 或 者 禁用 调试 模式 的 情况 被 重新 编译 。 
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将 调试 模式 信息 重 定向 到 Android 日 志 


默认 情况 下 ， 错 误 信 息 会 显示 在 标准 错误 输出 里 。STLport 可 以 通过 将 错误 信息 重 定 
向 到 自 定 义 函数 来 重 写 默认 的 行为 。 要 实现 这 一 点 ， 请 按照 下 列 步骤 操作 。 

(1) 修改 Android.mk 构建 文件 定义 STLP DEBUG MESSAGE 预 处 理 宏 ， 如 程序 清 
单 11-10 所 示 : 


程序 清单 11-10 ”启用 自 定义 调试 信息 输出 函数 


LOCAL MODULE := module 


LOCAL CFLAGS += —D_STLP_ DEBUG 
LOCAL CFLAGS += —D_STLP DEBUG MESSAGE 
LOCAL LDLIBS += 一 11og 


include $ (BUILD SHARED LIBRARY) 


(2) 实现 全 局 函数 _stl_debug_message 将 错误 信息 重 定 向 到 Android 日 志 ， 如 程序 清 
单 11-11 所 示 。 


程序 清单 11-11 __stl_debug_message 函数 的 实现 


#include <stdarg.h> 
#include <android/log.h> 


void _ stl debug message(const char* format str, ...) 
{ 


va list ap; 


va_start(ap, format str); 
_ android log vprint (ANDROID LOG FATAL, "STLport", format str, ap); 
va_end (ap); 


} 


根据 上 面 作出 的 修改 ，STL 调试 信息 和 STLport 标签 、 日 志 级 别 FATAL 会 被 重 定向 
到 Android 日 志 ， 而 且 这 些 日 志 可 以 通过 logcat 进行 监控 。 


11.9 小结 


本 章 开始 探讨 通过 Android 平台 和 Android NDK 提供 的 C++ 运行 库 支 持 。 根 据 所 提供 
的 功能 对 Android NDK 支持 的 不 同 C++ 运行 库 进行 了 比较 ， 如 C++ 异常 支持 和 C++ RTTI 
支持 。C++ 标 准 库 是 非常 庞大 和 复杂 ， 本 章 介绍 了 线程 安全 和 调试 模式 的 C++ 运行 库 ， 用 
来 排除 原生 应 用 中 对 C++ 组 件 无 效 使 用 的 相关 故障 。 第 12 章 将 看 到 C++ 标准 库 函 数 在 应 
用 中 的 示例 。 
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原生 图 形 API 


毋庸 置疑 ， 游 戏 和 多 媒体 应 用 程序 是 从 Android NDK 中 获 益 最 多 的 。 这 些 应 用 程序 依 
靠 原 生 代码 来 进行 性 能 相关 的 操作 。 对 于 这 些 应 用 程序 来 说 ， 能 从 原生 代码 层 直接 向 显示 
器 泻 染 图 像 是 至 关 重 要 的 。 本 章 将 探讨 下 面 几 个 Android NDK 提供 的 原生 图 形 API: 

e JNI 图 形 API( 也 叫 位 图 APD 

® OpenGL ES 1.xand 2.0 

e 原生 Window API 

我 们 将 在 本 章 用 各 种 可 用 的 原生 图 形 API 构建 一 个 AVI 视频 播放 应 用 程序 , 以 此 作为 
演示 视频 帧 泻 染 的 测试 平台 。 


12.1 原生 图 形 API 的 可 用 性 


并 不 是 所 有 的 原生 图 形 API 对 各 个 版 本 的 Android 操作 系统 都 是 可 用 的 。 随 着 时 间 的 
推移 所 介绍 的 这 些 API 只 适用 于 众多 Android 版 本 的 一 个 子 集 。 可 用 的 原生 图 形 API 如 
表 12-1 所 示 : 


表 12-1_ 可 用 的 原生 图 形 API 


Native Graphics API API Level 
JNLGraphics API 8 及 以 后 
OpenGL ES 1x 4 及 以 后 
OpenGL ES 2.0 5 及 以 后 
原生 Window 2.3 及 以 后 9 及 以 后 


在 深入 探究 用 原生 代码 显示 图 形 之 前 ， 我 们 将 先 创建 一 个 简单 的 AVI 视频 播放 应 用 
程序 。 
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12.2 创建 一 个 AVI 视频 播放 器 


这 个 AVI 视频 播放 应 用 程序 将 充当 一 个 测试 平台 。 在 本 章 中 , 我 们 将 不 断 地 扩展 这 个 
测试 应 用 程序 来 试验 在 原生 空间 中 各 种 不 同 的 可 用 原生 图 形 API， 该 示例 应 用 程序 包括 以 
下 功能 : 

。 它 是 一 个 支持 原生 代码 的 Android 应 用 程序 项 目 。 

。 一 个 静态 链接 AVI 库 , 其 中 包含 了 一 些 提供 给 Java 层 使 用 的 基本 函数 并 与 activity 

的 生命 周期 绑 定 。 

e 一 个 简单 的 GUI 界面 来 指定 播放 的 AVI 视频 文件 的 名 字 以 及 原生 图 形 API 的 类 型 。 

播放 AVI 视频 文件 需要 解析 AVI 文件。 虽然 AVI 文件 格式 不 是 非常 复杂 ， 但 为 了 简 
单 起 见 ， 我 们 将 使 用 一 个 叫做 AVILib 的 第 三 方 AVI 库 来 处 理 AVI 文件 。 


12.2.1 将 AVILib 作为 NDK 的 一 个 导入 模块 


AVILib 库 来 自 于 一 个 名 为 Transcode 的 大 型 开源 项 目 . 可 以 按照 下 面 的 步骤 使 AVILib 
成 为 一 个 NDK 导入 模块 以 便 使 用 。 

(1) 用 你 喜欢 的 浏览 器 打开 http://tcforge.berlios.de/。 

(2) 编写 本 书 时 ，Transcode 的 最 新 版 本 是 1.1.5。 单 击 Download 链接 下 载 transcode- 
1.1.5.tar.bz2 源 压缩 包 。 

(3) 如 果 你 用 的 是 Mac OS 或 者 Linux， 打 开 一 个 终端 窗口 ， 如 果 使 用 Windows， 打 开 
Cygwin。 

(4) 在 命令 行 输入 下 面 的 命令 将 Android NDK 导入 模块 目录 改 为 当前 工作 目录 。 


cd $ANDROID NDK HOME/sources 


(5) transcode 的 源 压 缩 文 件 是 用 BZip2 压缩 的 TAR 文件 。 用 下 载 的 transcode-1.1.5.tar.bz2 
文件 的 存放 目录 名 字 替 换 掉 <Download Location>， 然 后 输入 以 下 命令 来 提取 压缩 包 中 的 
文件 : 


tar jxvf <Download Location>/transcode-1.1.5.tar.bz2 

(6) 用 以 下 的 命令 将 当前 的 目录 改 为 Transcode 的 avilib 子 目 录 : 

cd transcode-1.1.5/avilib 

(7) 在 Eclipse 中 打开 platform.h 头 文件 。 在 config.h 头 文件 包含 附近 添加 粗 体 行 的 语 
句 ， 如 程序 清单 12-1 所 示 。 


程序 清单 12-1 修改 AVILIB platform.h 头 文件 的 内 容 


#ifndef PLATFORM H 
#define PLATFORM H 


#ifdef HAVE CONFIG H 
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#include "config-h" 
#endif 


#ifdef OS DARWIN 
#include <sys/uio.h> 
#endif 


之 所 以 这 样 修改 是 因为 将 通过 Android NDK 构建 系统 而 不 是 Transcode 项 目的 Makefile 
来 完成 AVILIB 的 编译 。 

(8) Android NDK 构建 系统 需要 它 自己 的 Android.mk 文件 中 的 导入 模块 .打开 Eclipse， 
在 当前 目录 下 创建 一 个 新 的 Android.mk， 内 容 如 程序 清单 12-2 所 示 。 


程序 清单 12-2 用 于 AVILib 导入 模块 的 Android.mk 构建 文件 


LOCAL PATH := $(call my-dir) 


# 
# 转 码 AVILib 
# 


# 源 文件 
MY _AVILIB SRC FILES := avilib.c Platform posix.c 


# 包含 导出 路 径 
MY_AVILIB C INCLUDES := $(LOCAL PRTH) 


# 

# AVILib 静态 

# 

include $ (CLEAR VARS) 


# 模块 名 称 
LOCAL MODULE := avilib static 


# 源 文件 
LOCAL SRC FILES := $ (MY AVILIB SRC FILES) 


# 包含 导出 路 径 
LOCAL EXPORT C INCLUDES := $ (MY AVILIB C_INCLUDES) 


# 构建 静态 库 
include $ (BUILD STATIC LIBRARY) 


# 

# AVILib 共享 

# 

include $ (CLEAR VARS) 


# 模块 名 称 
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LOCAL MODULE := avilib shared 


# 源 文件 
LOCAL SRC FILES := $ (MY AVILIB SRC FILES) 


# 包含 导出 路 径 
LOCAL EXPORT C INCLUDES := S$(MY AVILIB C INCLUDES) 


# 构建 共享 库 

include $ (BUILD SHARED LIBRARY) 

该 构建 脚本 为 AVILib 库 定义 了 一 个 静态 导入 模块 和 一 个 共享 导入 模块 。 

AVILib 库 现在 准备 好 了 。 下 面 将 着 手 实 现 AVI Player 示例 项 目 ， 它 将 用 AVILib 库 来 
播放 AVI 格 式 的 视频 文件 。 


12.2.2 创建 AVI 播放 器 Android 应 用 程序 


正如 本 书 前 面 所 述 , 在 Eclipse 中 启动 New Android Application Project 对 话 框 , 完成 以 
下 步骤 : 

(1) 将 Application Name 设置 为 AVI Player。 

(2) 将 Project Name 设置 为 AVI Player。 

(3) 将 Package Name 设置 为 com.apress.aviplayer。 

(4) 单 击 Next 按钮 接受 其 他 设置 采用 默认 值 。 

(5) 单 击 Next 按钮 接受 使 用 默认 的 启动 图 标 。 

(6) 取消 选中 Create Activity， 并 单 击 Finish 按钮 创建 一 个 空 的 AVI Player 项 目 。 

(7) 想 要 添加 原生 支持 ， 打 开 Project Explorer， 通 过 Android Tools 的 上 下 文 菜单 打开 
Add Android Native Support 向 导 。 

(8) 将 Library Name 设置 为 AVIPlayer。 

(9) 单 击 Finish 按钮 将 原生 支持 添加 到 AVI Player 项 目 。 


12.2.3 创建 AVI Player 的 Main Activity 


main activity 将 提供 一 个 简单 的 GUI 界面 ， 用 于 指定 AVI 视频 文件 名 和 用 于 演 染 的 原 
生 图 形 API 类 型 .打开 Eclipse, 选择 顶部 菜单 栏 的 New | Other, 展开 Android, 选择 Android 
Activity， 并 且 单 击 Next 启动 一 个 新 的 Android Activity 对 话 框 ， 完 成 以 下 步 又; 

(1) 选择 Blank Activity 模板 。 

(2) 单 击 Next 按钮 继续 。 

(3) 设置 Activity 的 名 字 为 MainActivity。 

(4) 单 击 Finish 按钮 接受 默认 的 设置 并 创建 一 个 新 的 activity。 

(5) 打开 Project Explorer， 打 开 AndroidManifest xml 清单 文件 ， 用 程序 清单 12-3 的 内 
容 替 换文 件 内 容 。 
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程序 清单 12-3 AndroidManifest.xml 文件 的 内 容 


<manifest xmlns:android="http://schemas .android.com/apk/res/android" 
Package="com.apress.aViplayer" 
android:versionCode="1" 
android:versionName="1.0" > 


<uses-sdk 
android:minsdkVersion="8" 
android:targetSdkVersion="15"” /> 


<application 
android:icon="@drawable/ic launcher" 
"@string/app_name" 
:theme="@style/AppTheme" > 
<activity 
android:name=" .MainActivity" 
android:label="@string/main activity title" > 
<intent-filter> 
<action android:name="android.intent.action.MAIN" /> 


<category 
android:name="android.intent.category.LAUNCHER" /> 
</intent-filter> 
</activity> 
</application> 
</manifest> 


(6) 打开 Project Explorer， 展 开 res 资源 日 录 。 进 入 到 values 子 目 录 ， 打 开 strings.xml 
字符 串 资 源 文件 。 用 程序 清单 12-4 中 的 内 容 替 换文 件 内 容 。 


程序 清单 12-4 “res/values/strings.xml 资源 文件 的 内 容 


<resources> 
<string name="app name">AVI Player</string> 
<string name="main activity title">MainActivity</string> 
<string name="file name hint">AVI Video File Name</string> 
<string name="file name text">galleon.avi</string> 
<string name="play button">Play</string> 
<string name="hello world">Hello world!</string> 
<string name="menu settings">Settings</string> 
<string name="error alert title">Error Occurred</string> 
</resources> 


(7) main activity 提供 一 个 非常 简单 的 GUI, 文本 区 域 用 来 指定 AVI 文件 名 、 单 选 按钮 
用 来 选择 所 使 用 的 原生 图 形 API。 打 开 Project Explorer， 展 开 res 目录 下 的 layout 子 目录 。 
打开 activity_main.xml 布局 文件 并 用 程序 清单 12-5 的 内 容 蔡 换文 件 内 容 。 
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程序 清单 12-5 ”res/layout/activity_main.xml 布局 文件 的 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:1layout height="match parent™" 
android:orientation="vertical" > 


<EditText 
android:id="@+id/file name edit" 
android:layout width="match parent" 
android:layout height="wrap content" 
android:ems="10" 
android:hint="@string/file name hint" 
android:text="@string/file name text" > 


<requestFocus /> 
</EditText> 


<RadioGroup 
android:id="@+id/player radio group" 
android:layout width="wrap_content" 
android:layout height="wrap content" > 


</RadioGroup> 


<Button 
android:id="@+id/play_button" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:text="@string/play button" /> 


</LinearLayout> 


(8) 最 后 ， 要 实现 activity。 使 用 Project Explorer 打开 MainActivity.java 源 文件 并 用 程 
序 清单 12-6 的 内 容 替换 文件 内 容 。 


程序 清单 12-6 ”MainActivity.java 源 文件 的 内 容 


package com.apress.aviplayer; 
import java.io.File; 


import android.app.Activity; 

import android.content.Intent; 

import android.os.Bundle; 

import android.os.Environment; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 
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import android.widget.EditText; 
import android.widget.RadioGroup; 


/** 

* Main activity. 

太 

* Q@author Onur Cinar 

BF 

public class MainActivity extends Activity implements OnClickListener { 
/** AVI 文件 名 字 编 辑 */ 
private EditText fileNameEdit; 


/** Player 类 型 的 单 选 组 */ 
private RadioGroup playerRadioGroup; 


/** Play 按钮 */ 
private Button playButton; 


/妇女 

* On create. 

娘 

* @param savedInstanceState saved state. 

二 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


fileNameEdit = (EditText) findViewById(R.id.file name edit); 
playerRadioGroup = (RadioGroup) findViewById!( 
R.id.player radio group); 


playButton = (Button) findViewById(R.id.play button); 
playButton.setOnClickListener (this); 


J 
*OnClick 事件 处 理 
页 
* @param view view instance. 
mp 
public void onClick(View view) { 
switch (view.getId()) { 
case R.id.play button: 
onPlayButtonClick(); 
break; 


Vid 


* 按 钮 单 击 时 的 事件 处 理 
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wf 
private void onpPlayButtonClick() { 
Intent intent; 


// 获 得 选择 的 单 选 按钮 的 id 


int radioId = playerRadioGroup .getCcheckedRadioButtonId () 7 


// 基于 id 选择 activity 
Switch (radioId) { 


// 本 章 的 后 面 会 在 此 处 添加 case 代码 
default: 
throw new UnsupportedOperationException( 
"radioId=" + radioId); 
} 


// 基于 外 部 存储 器 
File file = new Filel(Environment .getExternalStorageDirectory(), 
fileNameEdit .getText() .tostring()); 


// 将 AVI 文件 的 名 字 作为 extra 内 容 
intent .putExtra (AbstractPlayerActivity.EXTRA FILE NAME, 
file.getAbsolutePath()); 


// 启动 player activity 
startActivity (intent); 


} 


12.2.4 创建 Abstract Player Activity 


当 用 不 同 的 原生 图 形 API 做 实验 时 ，AVI 播放 器 代码 的 实现 很 大 程度 上 是 相同 的 ， 例 
如 打开 或 者 关闭 AVI 文件 。 抽 象 player activity 会 提取 公共 的 代码 ， 只 让 子 类 通过 继承 它 
来 完成 实际 播放 器 实现 的 泻 染 部 分 。 按 照 以 下 步骤 来 实现 abstract player activity。 

(1) 打开 Project Explorer， 展 开 src 目录 。 

(2) 右 击 com.apress.aviplayer 包 。 

(3) 在 上 下 文 菜单 中 选择 New | Class 启动 一 个 New Java Class 对 话 框 。 

(4) 将 Name 设置 为 AbstractPlayerActivity。 

(5) 单 击 Finish 按钮 来 创建 一 个 新 的 类 。 

(6) 用 程序 清单 12-7 中 的 内 容 替 换 AbstractPlayerActivity.java 源 文件 的 内 容 。 


程序 清单 12-7 ”AbstractPlayerActivityjava 源 文 件 的 内 容 


package com.apress.aviplayer; 
import java.io.IOException; 


import android.app.Activity; 
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import android.app.AlertDialog; 


J/ 
* Player activity. 
太 
* @author Onur Cinar 
public abstract class AbstractPlayerActivity extends Activity { 
/** AVI 文件 名 字 的 extra */ 
public static final String EXTRA FILE NAME = 
"com.apress.aviplayer .EXTRA FILE NAME™"; 


/** AVI 视频 文件 描述 符 */ 


protected long avi = 0; 


/** 
* On start. 
# 
protected void onstart() { 
super.onstart (); 


// 打开 AVI 文件 
try { 
avi = open(getFileName ()); 
} catch (IOException e) { 
new AlertDialog.Builder (this) 
.setTitle(R.string.error alert title) 
.SetMessage (e.getMessage () ) 
.Show() 7? 


/** 

* On stop. 

sy 

protected void onStop () { 
Super .onStop () 7 


// 如 果 AVI 视频 是 打开 的 
if (0 != avi) { 
// 关 闭 文件 描述 符 
close (avi); 
avi = 0; 


/太太 


* 获 取 AVI 视频 文件 的 名 字 


和 


* 返回 文件 名 字 
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wR 
protected String getFileName() { 
return getIntent () .getExtras() -getString (EXTRA FILE NAME); 


/**# 
* 打 开 指 定 的 AVI 文件 并 且 返 回 一 个 文件 描述 符 
* @param fileName file name. 
* @return file descriptor. 
* @throws IOException 
wf 
protected native static long open(String fileName) 
throws IOException; 


/** 
* 获 得 视频 宽度 


* @param avi file descriptor. 
* Q@return video width. 
3 
protected native static int getWidth(long avi); 


/** 
* 获 得 视频 高 度 


* @param avi file descriptor. 
* @return video height. 
yy 
protected native static int getHeight (long avi); 


/太太 
* 获 得 帧 速 


* Q@param avi file descriptor. 
* @return frame rate. 
op 
protected native static double getFrameRate (long avi); 


Ls 


* 基 于 给 定 的 文件 描述 符 关闭 指定 的 AVI 文件 


大 


* @param avi file descriptor. 
Sg 
protected native static void close(long avi); 


static { 
System.1loadLibrary ("AVIPlayer"); 
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AbstractPlayerActivity 还 包含 一 些 用 来 处 理 AVI 视频 文件 的 原生 方法 。 这 些 方法 需要 
在 原生 空间 中 实现 。 

(7) 在 项 部 菜单 栏 中 选择 Project | Build Project 来 编译 Java 源 代码 ,之 后 可 以 使 用 javah 
工具 生成 为 实现 AbstractPlayerActivity 原生 部 分 的 必要 的 头 文件 。 

(8) 打开 Project Explorer， 选 中 AbstractPlayerActivity。 

(9) 在 项 部 菜单 栏 中 选择 Run | External Tools | Generate C and C++ Header File 来 为 
AbstractPlayerActivity 类 调用 javah 工具 。 

(10) 在 项 目的 jni 子 目录 下 , javah 工具 将 生成 com_apress_aviplayer_AbstractPlayerActivity.h 
头 文件 ， 内 容 如 程序 清单 12-8 所 示 。 


程序 清单 12-8 ”com_apress_aviplayer_AbstractPlayerActivity.h 的 内 容 
/* 不 要 编辑 这 个 文件 ， 它 是 由 系统 生成 的 */ 


#include <jni.h> 
/* 类 com apress aviplayer AbstractPlayerActivity 的 头 文件 */ 


#ifndef Included com apress aviplayer AbstractPlayerActivity 
#define _Included com apress aviplayer AbstractPlayerActivity 
#ifdef _ cplusplus 

extern "C" { 

#endif 


/* 

* Class: com apress aviplayer AbstractPlayerActivity 

* Method: open 

* Signature: (Ljava/lang/string;)J 

*y 

JNIEXPORT jlong JNICALL Java_ com apress aviplayer AbstractPlayerActivity open 
(UNIEnV *, jclass, jstring); 


/* 
* Class: com apress aviplayer AbstractPlayerActivity 
* Method: getWidth 
* Signature: (J)I 
本 
JNIEXPORT jint JNICALL Java_com_apress_avViplayer_AbstractPlayerRctivity 
getwidth 
(UNIEnv *, jclass, jlong); 


/* 

* Class: com apress aviplayer AbstractPlayerActivity 

* Method: getHeight 

* Signature: (J)I 

be 

JNIEXPORT jint JNICALL Java com apress aviplayer AbstractPlayerActivity_ 
getHeight 
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(UNIEnV *, jclass, jlong); 


/* 
* Class: Com apress aviplayer AbstractPlayerActivity 
* Method: getFrameRate 
* Signature: (J)D 
je 
JNIEXPORT jdouble JNICALL Java com apress aviplayer AbstractPlayerActivity 
getFrameRate 
(UNIEnv *, jclass, jlong); 


/* 
* Class: com apress aviplayer AbstractPlayerActivity 
* Method: close 
* Signature: (J)V 
WA 
JNIEXPORT void JNICALL Java com apress aviplayer AbstractPlayerActivity_ 
close 
(UNIEnv *, jclass, jlong); 


#ifdef _cplusplus 
} 

#endif 

#endif 


(11) 为 了 实现 这 些 原生 函数 ， 需 要 一 个 新 的 C++ 源 文件 。 右 击 jni 目录 ， 在 上 下 文 菜 
单 中 选择 New | Source File。 

(12) 将 Source File 设置 为 com apress_aviplayer_AbstractPlayerActivity.cpp。 

(13) 单 击 Finish 按钮 来 创建 一 个 新 的 C++ 源 文件 。 

(14) Abstract player activity 的 原生 方法 提供 了 通过 AVILib 这 个 第 三 方 库 所 提供 的 API 
解析 指定 AVI 视频 文件 的 功能 。 打 开 Eclipse， 用 程序 清单 12-9 的 内 容 替 换 com_apress_ 
aviplayer_AbstractPlayerActivity.cpp 源 文件 的 内 容 。 


程序 清单 12-9 com_apress_aviplayer_AbstractPlayerActivity.cpp 的 内 容 


extern "C" { 
#include <avilib.h> 


} 


#include "Common.h" 
#include "com apress aviplayer AbstractPlayerActivity.h" 


jlong Java_ com apress aviplayer AbstractPlayerActivity open( 
JNIEnv* env, 
jclass clazz, 
jstring fileName) 


avi t* avi = 0; 
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// 获 取 文 件 名 字 赋 给 c 的 一 个 字符 串 变量 


Const char* cFileName = enV->GetStringUTFChars (fileName, 0); 
if (0 == cFileName) 
和 


goto exit; 


// 打 开 AVI 文件 


avi = AVI open input file(cFileName, 1); 


// 释放 文件 名 字 


env->ReleaseStringUTFChars (fileName, cFileName); 


// 如 果 AVI 文件 不 能 打开 则 抛 出 一 个 异常 
if (0 == avi) 


ThrowException (env, "java/io/IOException", AVI strerror()); 


exit: 
return (jlong) avi; 


jint Java com apress aviplayer AbstractPlayerActivity getWidth( 
JNIEnv* env, 
jclass clazz, 
jlong avi) 


return AVI video width((avi t*) avi); 


jint Java com apress aviplayer AbstractPlayerActivity getHeight( 
JNIEnVv* env, 
jclass clazz, 
jlong avi) 


return AVI video height ((avi t*) avi); 
jdouble Java com apress aviplayer AbstractPlayerActivity getFrameRate( 
JUNIEnVx env, 
jclass clazz, 
jlong avi) 
return AVI frame rate((avi t*) avi); 
void Java com apress aviplayer AbstractPlayerActivity close( 


JNIEnv* env, 
jclass clazz, 
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jlong avi) 
{ 
AVI close((avi tx*) avi); 


} 

(15) 不 同 播 放 器 实现 的 Abstract player activity 原生 代码 部 分 将 会 共享 一 些 通用 代码 。 
这 些 通 用 代码 将 由 Common.h 和 Common.cpp 源 文件 提供 。 右 击 jni 目录 , 在 上 下 文 菜单 中 
选择 New | Header File。 

(16) 将 Header File 设置 为 Common.h。 

(17) 单 击 Finish 按钮 创建 一 个 新 的 头 文件 。 

(18) 用 程序 清单 12-10 的 内 容 替 换 新 头 文件 的 内 容 。 


程序 清单 12-10 ”Common.h 头 文件 的 内 容 


#pragma once 
#include <jni.h> 


/*# 


* 使 用 给 定 的 异常 类 和 异常 信息 抛 出 一 个 新 的 异常 


* @param env JNIEnv interface. 
* @param className class name. 
* @param message exception message. 
wt 
void ThrowException( 
JNIEnv* env, 
const char* className, 
const char* message); 


(19) 右 击 jni 目录 ， 在 上 下 文 菜单 中 选择 New | Source File。 
(20) 将 Source File 设置 为 Common.cpp。 

(21) 单 击 Finish 按钮 来 创建 一 个 新 的 C++ 源 文件 。 

(22) 用 程序 清单 12-11 的 代码 替换 新 源 文件 的 内 容 。 


程序 清单 12-11 Common.cpp 源 文 件 的 内 容 


#include "Common.h" 


void ThrowException( 
JNIEnv* env, 
const char* className, 
const char* message) 


// 获取 异常 类 


jclass clazz = env->FindClass (className); 


// 如 果 找 到 异常 类 


if (0 != clazz) 
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// 抛 出 异常 


env->ThrowNew (clazz, message); 


// 释放 本 地 类 引用 


env->DeleteLocalRef (clazz); 
} 


(23) 现在 应 该 更 新 原生 项 目的 构建 文件 使 其 包含 新 的 源 文 件 ， 同 时 静态 地 链接 到 
AVILib 第 三 方 模块 上 。 在 jni 子 目 录 中 打开 Android.mk 文件 并 用 程序 清单 12-12 的 代码 替 
换文 件 内 容 。 

程序 清单 12-12 ”Android.mk 构建 文件 的 内 容 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := AVIPlayer 
LOCAL SRC FILES := \ 
Common.cpp \ 
com apress aviplayer AbstractPlayerActivity.cpp 
# 使 用 AVILib 静态 库 
LOCAL STATIC LIBRARIES += avilib static 


include $ (BUILD SHARED LIBRARY) 


# 引入 AVILib 库 模 块 


$(call import-module，transcode-1.1.5/avilib) 


(24) 虽然 现在 还 没 实现 AVI 视频 播放 的 泻 染 功能 , 但 也 要 构建 它 并 在 模拟 器 上 运行 该 
示例 应 用 程序 ， 以 确保 在 进行 下 一 步 之 前 它 已 被 正确 实现 。 


12.3 ”使 用 JNI 图 形 API 进行 泻 染 


Android 框架 提供 了 android.graphics.Bitmap 类 用 来 在 Java 代码 中 操作 和 使 用 bitmap 
像素 缓存 。 从 Android 2.2(API Level 8) 开 始 ，Android 提供 了 JNI Graphics API， 可 以 使 用 
原生 代码 访问 和 操作 Bitmap 对 象 的 像素 缓存 。 


12.3.1 启用 JNI Graphics API 


在 你 的 原生 应 用 程序 中 ， 按 照 以 下 步骤 进行 操作 以 使 用 JNI Graphics API: 
(1) 包含 android/bitmap.h 头 文件 。 


#include <android/bitmap.h> 
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(2) 修改 Android.mk 构建 文件 以 动态 地 与 jnigraphics 库 进 行 链 接 。 
LOCAL LDLIBS += -ljnigraphics 


做 了 以 上 修改 之 后 ， 现 在 JNI 图 形 API 已 经 可 以 你 的 原生 应 用 程序 中 使 用 了 。 
12.3.2 ”使 用 JNI Graphics API 


JNI Graphics API 提供 了 4 个 原生 函数 用 于 访问 和 操作 Bitmap 对 象 。 
1. 检索 Bitmap 对 象 信息 


AndroidBitmap_getInfo 函数 允许 原生 代码 检索 Bitmap 对 象 信息 ， 如 它 的 大 小 、 像 素 格 


int RndroidBitmap_getInfo(JNIEnvx env, 
jobject bitmap, 
AndroidBitmapInfo* info); 


该 函数 以 JNI 接口 指针 、Bitmap 对 象 的 引用 、 一 个 指向 AndroidBitmapInfo 结构 体 的 
指针 为 参数 ， 该 结构 返回 指定 bitmap 的 信息 ， 如 程序 清单 12-13 所 示 。 


程序 清单 12-13 ”AndroidBitmaplnfo 结构 体 的 声明 


typedef struct { 
uint32 t width; 
uint32 t height; 
uint32 t stride; 
int32 t format; 
uint32 t flags; 

} AndroidBitmapInfo; 


format 字段 包含 了 像素 格式 信息 ， 如 程序 清单 12-14 所 示 。 


程序 清单 12-14 AndroidBitmapFormat 枚 举 的 声明 


enum AndroidBitmapFormat { 
ANDROID_ BITMAP FORMAT NONE 
ANDROID BITMAP FORMAT RGBA 8888 
ANDROID BITMAP FORMAT RGB 565 
ANDROID BITMAP FORMAT RGBA 4444 
ANDROID BITMAP FORMAT A 8 


LI i i | 
mAPO 


}; 


成 功 的话 ，AndroidBitmap_getInfo 函数 会 返回 0;， 否则 会 返回 一 个 负数 。 在 android/ 
bitmap.h 头 文件 中 可 以 找到 全 部 的 错误 码 列表 。 


2. 访问 原生 像素 缓存 
AndroidBitmap lockPixels 函数 锁定 了 像素 缓存 以 确保 像素 的 内 存 不 会 被 移动 。 如 果 原 
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生 应 用 程序 想 要 访问 像素 数据 并 操作 它 ， 该 方法 返回 了 像素 缓存 的 一 个 原生 指针 。 
int AndroidBitmap lockPixels (JNIEnv* env, 
jobject jbitmap, 
void** addrPtr) 7 
该 函数 的 参数 为 INIEnv 接口 指针 、Bitmap 对 象 的 引用 和 void 指针 ， 用 来 返回 原生 像 
素 缓存 的 地 址 。 成 功 的 话 返 回 0; 否则 返回 一 个 负数 。 和 AndroidBitmap_getInfo 函数 一 样 ， 
AndroidBitmap_ lockPixels 函数 的 全 部 错误 码 列 表 可 以 在 android/bitmap.h 头 文件 中 找到 。 


3. 释放 原生 像素 缓存 


对 AndroidBitmap_lockPixels 的 每 次 调用 都 应 该 对 应 一 次 AndroidBitmap_unlockPixels 
调用 ， 用 来 释放 原生 像素 缓 在。 当 完 成 对 原生 像素 缓存 的 读 写 时 ， 原 生 应 用 程序 应 该 释放 
它 。 一 旦 释放 ，Bitmap 对 象 就 可 以 在 Java 层 使 用 了 。 


int AndroidBitmap unlockPixels (JNIEnv* env,jobject jbitmap); 


AndroidBitmap_unlockPixels 函数 的 参数 是 一 个 INIEnv 接口 指针 和 Bitmap 对 象 的 引 
用 。 成 功 的 话 ， 返 回 0; 否则 ， 返 回 一 个 负数 。 


12.3.3 用 Bitmap 泻 染 来 更 新 AVI Player 


想 要 修改 AVIplayer， 可 以 执行 以 下 步骤 : 
(1) 打开 Project Explorer， 打 开 AndroidManifestxml 清单 文件 并 且 声明 一 个 新 的 activity， 
如 程序 清单 12-15 所 示 。 


程序 清单 12-15 ”Manifest 文件 中 声明 的 新 Bitmap Player Activity 


<manifest xmlns:android="http://schemas .android.com/apk/res/android" 
package="com.apress.aviplayer" 
android:versionCode="1" 
android:versionName="1.0" > 


<application 
android:icon="@drawable/ic launcher" 
android:label="@string/app_name" 
android:theme="@style/AppTheme" > 


<activity 
android:name=" .BitmapP1ayerRActivity" 
android:1label="@string/title activity bitmap player" > 
</activity> 
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</application> 


</manifest> 


(2) 新 Bitmap Player activity 的 标题 以 及 Bitmap Player 单 选 按钮 的 标识 都 应 该 添加 到 字 
符 串 资源 中 。 打开 strings.xml 字符 串 资源 文件 ， 并 添加 新 的 字符 串 资源 ， 如 程序 清单 12-16 
所 示 。 

程序 清单 12-16 ”所 添加 的 Bitmap Player activity 字符 串 资源 


<resources> 


<string name="bitmap player radio">Bitmap Player</string> 
<string name="title activity bitmap player">Bitmap Player</string> 


</resources> 


(3) Bitmap Player activity 想 要 运行 的 话 ， 需 要 一 个 单独 的 SurfaceView 小 控件 。 打 开 
Project Explorer， 展 开 res 目录 。 

(4) 右 击 layout 子 目 录 ， 在 上 下 文 菜单 中 选择 New | File。 

(5) 将 File Name 设置 为 activity_bitmap_player.xml。 

(6) 用 程序 清单 12-17 的 内 容 替 换 新 布局 文件 内 容 。 


程序 清单 12-17 ”activity_bitmap_player.xml 布局 文件 的 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match Parent" 
android:layout height="match parent" > 


<SurfaceView 
android:layout width="match _ parent" 
android:layout height="match parent" 
android:id="@+id/surface view" /> 


</LinearLayout> 


(7) 打开 Project Explorer， 展 开 src 目录 。 

(8) 右 击 com.apress.aviplayer 包 名 ， 在 上 下 文 菜 单 中 选择 New | Class。 
(9) 将 Name 设置 为 BitmapPlayerActivity。 

(10) 单 击 Finish 按钮 创建 一 个 新 类 。 

(11) 用 程序 清单 12-18 的 内 容 替 换 新 类 的 内 容 。 


程序 清单 12-18 ”BitmapPlayerActivity 源 文件 的 内 容 


package com.apress.aviplayer; 
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import java.util.concurrent.atomic.AtomicBoolean; 


import android.graphics.Bitmap; 

import android.graphics.Canvas; 

import android.os.Bundle; 

import android.view.SurfaceHolder; 

import android.view.SurfaceHolder.Callback; 
import android.view.SurfaceView; 


/** 

* 使 用 bitmap 的 AVI player 
* @author Onur Cinar 

这 


public class BitmapPlayerActivity extends AbstractPlayerActivity { 
/** 正在 播放 */ 


private final AtomicBoolean isPlaying = new AtomicBoolean(); 


/** Surface holder. */ 
private SurfaceHolder surfaceHolder; 


/女友 
* 创建 过 程 


* Q@param savedInstanceState saved state. 

bt 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity bitmap player); 


SurfaceView surfaceView = (SurfaceView) 
findViewById (R.id.surface view); 


surfaceHolder = surfaceView.getHolder(); 
surfaceHolder.addCcallback (surfaceHolderCallback); 


/妇女 
* Surface holder 监听 surface 事件 的 回调 
A 
private final Callback surfaceHolderCallback = new Callback() { 
public void surfaceChanged (SurfaceHolder holder, int format, 
int width, int height) { 


public void surfaceCreated(SurfaceHolder holder) { 
//surface 准备 好 后 开始 播放 


isPlaying.set (true) 7 
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// 在 一 个 单独 的 线程 中 渲染 


new Thread (renderer) .start (); 


} 


public void surfaceDestroyed(SurfaceHolder holder) { 
// Surface 销毁 后 停止 播放 


isPlaying.set (false) 7 


] 


/** 
* 泻 染 线程 通过 一 个 bitmap 将 AVI 文件 中 的 视频 帧 泻 染 到 surface 上 
pF 
private final Runnable renderer = new Runnable() { 
public void run() { 
// 创建 一 个 新 的 bitmap 来 保存 所 有 的 帧 
Bitmap bitmap = Bitmap.createBitmap( 
getwidth (avi), 
getHeight (avi), 
Bitmap.Config.RGB 565); 


// 使 用 帧 速 来 计算 延迟 
long frameDelay = (long) (1000 / getFrameRate (avi)); 


// 播放 的 时 候 开 始 泻 染 
while (isPlaying.get()) { 
// 将 帧 泻 染 至 bitmap 


render (avi, bitmap); 


// 锁 定 canvas 


Canvas canvas = surfaceHolder.lockCanvas(); 


// 将 bitmap 绘制 至 canvas 
canvas.drawBitmap (bitmap, 0, 0, null); 


// canvas 准备 显示 


surfaceHolder.unlockCanvasAndPost (canVas) 


// 等 待 下 一 帧 

try { 
Thread.sleep (frameDelay); 

} catch (InterruptedException e) { 
break; 

} 


3 


/太太 


* 从 AVI 文件 描述 符 输 出 到 指定 Bitmap 来 泻 染 帧 
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param avi file descriptor. 
@param bitmap bitmap instance. 
@return true if there are more frames, false otherwise. 
Sp 
private native static boolean render(long avi, Bitmap bitmap); 


} 


BitmapPlayerActivity 通过 一 个 叫做 render 的 原生 方法 来 处 理 视频 帧 的 泻 染 。 

(12) 在 顶部 菜单 栏 中 选择 Project | Build 来 编译 Java 源 代码 。 

(13) 打开 Project Explorer 选择 BitmapPlayerActivity。 

(14) 在 主 菜单 栏 中 选择 Run | External Tools | Generate C and C++ Header File 来 对 
BitmapPlayerActivity 类 调用 javah 工具 。 

(15) 在 项 目的 jni 子 目 录 下 ，javah 工具 将 生成 一 个 com_apress_aviplayer Bitmap- 
PlayerActivityh 头 文件 。 

(16) 右 击 jni 目录 ， 在 上 下 文 菜单 中 选择 New | Source File。 

(17) 将 Source File 设置 为 com apress_aviplayer_BitmapPlayerActivity.cpp。 

(18) 单 击 Finish 按钮 来 创建 一 个 新 的 C++ 源 文件 。 

(19) 打开 Eclipse， 用 程序 清单 12-19 的 内 容 替 换 新 源 文件 的 内 容 。 


程序 清单 12-19 com_apress_aviplayer_BitmapPlayerActivity.cpp 的 内 容 


extern "C" { 
#include <avilib.h> 


} 
#include <android/bitmap.h> 


#include "Common.h" 
#include "com apress aviplayer BitmapPlayerActivity.h" 


jboolean Java com apress aviplayer BitmapPlayerActivity render( 
JNIEnVv* env, 
jclass clazz, 
jlong avi, 
jobject bitmap) 


jboolean isFrameRead = JNI_FALSE; 


char* frameBuffer = 0; 
long frameSize = 0; 
int keyFrame = 0; 


// 锁 定 bitmap 并 得 到 raw byte 
if (0 > AndroidBitmap lockPixels(env, bitmap, (void**) &frameBuffer) 
{ 
ThrowException (env, "java/io/IOException", 
"Unable to lock pixels."); 
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goto exit; 


和 


// 将 AVI 帧 byte 读 到 bitmap 中 


frameSize = AVI read frame((avi tx*) avi, frameBuffer, &keyFrame); 


// 解锁 bitmap 
if (0 > AndroidBitmap unlockPixels (env, bitmap)) 
{ 
ThrowException (env, "java/io/IOException", 
"Unable to unlock pixels."); 
goto exit; 
站 


// 检查 帧 是 否 成 功 读 取 
if (0 < frameSize) 
{ 
isFrameRead = JNI_TRUE; 


exit: 
return isFrameRead; 


} 
(20) 需要 修改 构建 文件 Android.mk 来 编译 新 的 源 文件 以 及 动态 链接 jnigraphics 共享 库 
来 使 用 JNI Graphics Bitmap API， 如 程序 清单 12-20 所 示 。 
程序 清单 12-20 ”修改 Bitmap Player 的 构建 文件 
LOCAL PATH := $(call my-dir) 


include $ (CLEAR VARS) 


LOCAL MODULE := AVIPlayer 

LOCAL SRC_FILES := \ 
Common.cpp \ 
com apress aviplayer AbstractPlayerActivity.cpp \ 
Com apress aviplayer BitmapPlayerActivity.cpp 


# Use AVILib static library 
LOCAL STATIC LIBRARIES += avilib static 


# Link with JNI graphics 
LOCAL LDLIBS += 一 1jnigraphics 


include $ (BUILD SHARED LIBRARY) 


# Import AVILib library module 
$ (call import-module, transcode-1.1.5/avilib) 
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(21) bitmap player activity 现在 准备 好 了 。 想 要 使 用 它 的 话 ， 需 要 把 它 作 为 一 个 单 选 按 
钮 添加 到 activity_main.xmil 布局 文件 中 ， 如 程序 清单 12-21 所 示 。 


程序 清单 12-21 将 Bitmap Player 单 选 按钮 添加 到 Main Activity 布局 中 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:1layout height="match parent" 
android:orientation="vertical" > 


<RadioGroup 
android:id="@+id/player radio group" 
android:layout width="wrap_content" 
android:layout height="wrap content" > 


<RadioButton 
android:id="@+id/bitmap player radio" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:checked="true" 
android:text="@string/bitmap player radio" /> 


</RadioGroup> 


</LinearLayout> 


(22) main activity 的 源 代码 也 需要 修改 ， 如 程序 清单 12-22 所 示 ， 当 用 户 选 择 时 ， 需 要 
向 Bitmap Player activity 发 送 播放 请 求 。 


程序 清单 12-22 ”将 Bitmap Player 单 选 按钮 事件 添加 到 Main Activity 中 


/**# 
* play 按钮 单 击 事件 处 理 
Private void onPlayButtonClick() { 


// 基于 id 选 择 activity 

switch (radioId) { 

Case R.id.bitmap player radio: 
intent = new Intent(this, BitmapPlayerActivity.class); 
break; 


default: 
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throw new UnsupportedOperationException("radioId=" + radioId); 


} 
12.3.4 ”运行 使 用 Bitmap 渲染 的 AVI Player 


现在 ， 基 于 JNI 图 形 API 使 用 Bitmap 泻 染 的 AVI Player 应 用 程序 准备 好 了 。 按 照 以 
下 步骤 执行 在 Android 模拟 器 上 测试 应 用 程序 。 

(1) 想 要 测试 这 个 AVI 视频 播放 器 应 用 程序 ， 需 要 一 个 AVI 格式 的 视频 文件 。 为 了 简 
化 示例 ， 应 用 程序 只 使 用 AVI 格式 作为 容器 ， 并 希望 视频 负载 是 通过 RGB565 颜色 空间 的 
未 压缩 原始 帧 来 提供 的 。 用 你 最 喜欢 的 浏览 器 从 作者 的 网 站 http://zdo.com/galleon.zip 下 载 
该 示例 视频 文件 。 

(2) 提取 下 载 的 ZIP 压缩 包 中 的 galleon.avi AVI 视频 文件 。 

(3) 启动 Android 模拟 器 。 

(4) 使 用 ADB， 将 AVI 视频 文件 推送 到 Android 模拟 器 的 SD 卡 中 ， 如 下 : 


adb push galleon.avi /sdcard/ 
注意 : 
galleon.avi AVI 视频 文件 需要 SD 卡 上 至 少 有 74MB 的 剩余 空间 。 如果 ADB push 文件 


出 错 ， 请 确保 Android 设备 或 者 Android 模拟 器 有 足够 的 空间 。 由 于 视频 文件 较 大 ， 将 它 
推送 到 SD 卡 上 要 花费 30 秒 或 者 更 多 的 时 间 。 


(5) 在 Android 模拟 器 上 启动 AVIplayer 应 用 程序 。 
(6) 确保 已 经 选中 Bitmap Player 单 选 按钮 ， 如 图 12-1 所 示 : 


© MainActivity 


galleon.avi 


© Bitmap Player 


Play 


图 12-1 使 用 AVI 播放 器 GUI 来 选择 Bitmap 播放 器 


(7) 单 击 Play 按钮 开始 播放 .Bitmap Player activity 将 会 被 调用 并 且 AVI 视频 文件 将 通 
过 JNI Graphics API 泻 染 ， 如 图 12-2 所 示 。 你 将 看 到 帆船 上 飘扬 的 白旗 。 


278 


第 12 章 原生 图 形 API 


24 B 3:09 


图 12-2 通过 Bitmap 泻 染 程序 泻 染 AVI 视频 文件 


12.4 使 用 OpenGL ES 泻 染 


Android NDK 为 原生 代码 提供 了 OpenGL ES 的 1x 和 2.0 图 形 API， 正 如 本 章 前 面 
所 示 。 

e Android 1.6 及 以 后 版 本 支持 的 OpenGL ES 1.0 

e 只 在 带 有 相应 的 GPU 的 特殊 设备 上 支持 OpenGL ES 1.1 

e Android 2.0 及 以 后 版 本 支持 的 OpenGL ES 2.0 

应 用 程序 应 该 在 Android 清单 文件 中 使 用 <uses-feature> 标 签 来 标识 要 使 用 的 OpenGL 
ES 的 首选 版 本 。 


12.4.1 使 用 OpenGL ES API 


想 要 使 用 OpenGL ES API, 需要 在 Java 代码 中 添加 一 个 android.opengl.GLSurfaceView 
实例 。 这 样 ， 原 生 应 用 程序 就 可 以 调用 OpenGL ES API 函数 向 GLSurfaceView 泻 染 图 像 。 
更 多 关于 可 用 OpenGL ES API 的 信息 可 以 在 Khronos Group 网 站 www.khronos.org/opengles/ 
上 查询 到 。 

本 书 编写 时 , Android 模拟 器 还 不 支持 OpenGL ES 2.0 硬件 模拟 ,为 了 体验 基于 OpenGL 
ES 的 图 形 API， 示 例 应 用 程序 将 使 用 OpenGL ES 1.x。 


12.4.2 启用 OpenGL ES 1.x API 


执行 以 下 步骤 在 原生 应 用 程序 中 使 用 OpenGL ES 1.x。 
(1) 包含 OpenGL ES 1.x 头 文件 。 


#include <GLES/g1L.h> 
#include <GLES/glext.h> 


(2) 修改 Android.mk 构建 文件 来 动态 链接 GLESv1_CM 库 。 
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LOCAL LDLIBS += ~-lGLESv]1 CM 


做 了 这 些 修改 后 ， 在 原生 应 用 程序 中 就 可 以 使 用 OpenGL ES 1.x API 了 。 
12.4.3 ”启用 OpenGL ES 2.0 API 


执行 以 下 步骤 在 原生 应 用 程序 中 使 用 OpenGL ES 2.0。 
(1) 包含 OpenGL ES 2.0 头 文件 。 


#include <GLES2/g12.h> 
#include <GLES2/gl2ext.h> 


(2) 修改 Android.mk 构建 文件 来 动态 链接 GLESv2 库 。 
LOCAL LDLIBS += -1GLESv2 


做 了 这 些 修改 后 ， 在 原生 应 用 程序 中 就 可 以 使 用 OpenGL ES 2.0 API 了 。 
12.4.4 用 OpenGL ES 泻 染 来 更 新 AVI Player 


执行 以 下 步骤 。 
(1) 打开 Project Explorer， 打 开 AndroidManifestxml 清单 文件 并 声明 新 的 activity， 如 
程序 清单 12-23 所 示 。 


程序 清单 12-23 ”在 清单 文件 中 声明 新 的 OpenGL Player Activity 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.apress.aviplayer" 
android:versionCode="]1" 
android:versionName="]1.0" > 


<application 
android:icon="@drawable/ic launcher" 
android:1label="@string/app_name" 
android:theme="@style/AppTheme" > 


<activity 
android:name=" .OpenGLP1ayerRActivity" 
android:1label="@string/title activity open gl player" > 
</activity> 
</application> 


</manifest> 


(2) 和 OpenGL player 单 选 按钮 一 样 , 新 的 OpenGL player activity 的 标题 应 该 添加 到 字 
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符 串 资源 文件 中 。 打开 strings.xml 字符 串 资源 文件 并 添加 新 的 字符 串 资源 , 如 程序 清单 12-24 
所 示 。 


程序 清单 12-24 ”添加 OpenGL Player Activity 字符 串 资源 


<resources> 


<string name="title activity open gl player">OpenGL Player</string> 
<string name="open gl player radio">OpenGL Player</string> 
</resources> 
(3) 想 要 运行 Bitmap Player activity 的 话 ， 需 要 一 个 单独 的 GLSurfaceView 小 控件 。 打 
开 Project Explorer， 展 开 res 目录 。 
(4) 右 击 layout 子 目录 ， 在 上 下 文 菜单 中 选择 New | File。 
(5) 将 File Name 设置 为 activity_open_ gl]_player.xml。 
(6) 用 程序 清单 12-25 的 内 容 蔡 换 新 的 布局 文件 内 容 。 


程序 清单 12-25 ”activity_open_gl_player.xml 布局 文件 的 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" > 


<android.opengl .GLSurfaceView 
android:layout width="match parent" 
android:layout height="match parent" 
android:id="@+id/gl] surface view" /> 


</LinearLayout> 


(7) 打开 Project Explorer， 展 开 src 目录 。 

(8) 右 击 com.apress.aviplayer 包 名 ， 在 上 下 文 菜单 中 选择 New | Class。 
(9) 设置 Name 为 OpenGLPlayerActivity。 

(10) 单 击 Finish 按钮 来 创建 新 的 类 。 

(11) 使 用 程序 清单 12-26 的 内 容 替 换 它 的 内 容 。 

程序 清单 12-26 ”OpenGLPlayerActivity.java 源 文件 的 内 容 


package com.apress.aviplayer; 
import java.util.concurrent.atomic.AtomicBoolean; 


import javax.microedition.khronos.egl .EGLConfig; 
import javax.microedition.khronos.opengles.GL10; 
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import android.opengl .GLSurfaceView; 
import android.opengl .GLSurfaceView.Renderer; 
import android.os.Bundle; 


/** 
* 使 用 OpenGL 的 AVI 播放 器 . 


和 

* Qauthor Onur Cinar 

当下 

public class OpenGLPlayerActivity extends AbstractPlayerActivity { 
/xx */ 正 在 播放 


private final AtomicBoolean isPlaying = new AtomicBoolean(); 


/** 原生 泻 染 器 */ 


private long instance; 


/** GL surface view 实例 */ 
private GLSurfaceView glSurfaceView; 


/** 
* On create. 
* 


* @param savedInstanceState saved state. 

WR 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity open gl player); 


glSurfaceView = (GLSurfaceView) 
findViewById(R.id.gl surface view); 


// 设置 泻 染 器 


glSurfaceView.setRenderer (renderer); 


// 请 求 时 泻 染 帧 
glSurfaceView.setRenderMode (GLSurfaceView.RENDERMODE WHEN DIRTY); 


/** 
* On start. 
A 
protected void onstart() { 
super.onstart (); 


// 初始 化 原生 演 染 器 


instance = init(avi) 7 


/** 
* On resume. 
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ey 
protected void onResume() { 
super.onResume (); 


// 当 activity resumed 时 必须 通知 GL surface 视图 
glSurfaceView.onResume (); 


/太太 
* On pause. 
wR 
protected void onPause() { 
super.onPause () 7 


// 当 activity paused 时 必须 通知 GL surface view 
glSurfaceView.onPause () 7 


/** 

* On stop. 

i 

protected void onstop() { 
super.onStop () 7 


// 释 放 原生 演 染 器 
free (instance); 
instance = 0; 


/** 
* 根 据 帧 速 请 求 泻 染 
二 
Private final Runnable player = new Runnable() { 
public void run() { 
// 使 用 帧 速 计算 延迟 
long frameDelay = (long) (1000 / getFrameRate (avi) ) 7 


// 播放 时 开始 泻 染 
while (isPlaying.get()) { 
// 请 求 浑 染 


glSurfaceView.requestRender (); 


// 等 待 下 一 帧 

try { 
Thread.sleep (frameDelay); 

} catch (InterruptedException e) { 
break; 


283 


droid C++ 高 级 编程 一 一 使 用 


] 


/二 坟 

* OpenGL renderer. 

private final Renderer renderer = new Renderer() { 
public void onDrawFrame (GL10 gl) { 


// 演 染 下 一 帧 
if (!renderl(instance, avi)) 
六 


isPlaying.set (false); 
public void onSurfaceChanged(GL10 gl, int width，int height) { 


public void onSurfaceCreated(GL10 gl, EGLConfig config) { 


// 初 始 化 openGL surface 
initSurface (instance, avi); 


// surface 准备 好 后 开始 播放 


isPlaying.set (true) 7 


// 启动 播放 器 
new Thread (player) .start() 7 


}; 


/*# 
* 初 始 化 原生 泻 染 器 
大 


* @param avi file descriptor. 

* @return native instance. 

3 

Private native static long init(long avi); 


/妇女 
* 初 始 化 openGL surface 
太 


* @param instance native instance. 
sy 
private native static void initSurface(long instance, long avi); 


/*#* 
* 用 给 定 文件 进行 帧 泻 染 


* @param instance native instance. 
* Qparam avi file descriptor. 
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* @return true if there are more frames，false otherwise- 
Sp 


private native static boolean render(long instance, long avi); 


/** 
* 释放 原生 演 染 器 


太 


* @param instance native instance. 
private native static void free (long instance) 7 
} 


(12) 从 项 部 菜单 栏 中 选择 Project | Build Project 编译 Java 源 代码 。 

(13) 打开 Project Explorer， 选 择 OpenGLPlayerActivity。 

(14) 在 主 菜单 中 选择 Run | External Tools | Generate C and C++ Header File 对 OpenGL- 
PlayerActivity 类 调用 javah 工具 。 

(15) 在 项 目的 jni 子 目录 下 ，javah 工具 会 生成 com_apress_aviplayer_ OpenGLPlayer- 
Activityh 头 文件 。 

(16) 右 击 jni 目录 ， 在 上 下 文 菜单 中 选择 New | Source File。 

(17) 将 Source File 设置 为 com apress_aviplayer OpenGLPlayerActivity.cpp。 

(18) 单 击 Finish 按钮 创建 一 个 新 的 C++ 源 文件 。 

(19) 打开 Eclipse， 用 程序 清单 12-27 的 内 容 蔡 换 新 的 源 文件 内 容 。 


程序 清单 12-27 com_apress_aviplayer_OpenGLPlayerActivity.cpp 的 内 容 


extern "C" { 
#include <avilib.h> 


} 


#include <GLES/g1.h> 
#include <GLES/glext.h> 
#include <malloc.h> 


#include "Common.h" 
#include "com apress aviplayer OpenGLPlayerActivity.h" 


struct Instance 


{ 
char* buffer; 
GLuint texture; 


Instance(): 


buffer (0), 
texture (0) 


] 7 
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jlong Java com apress aviplayer OpenGLPlayerActivity init( 
JNIEnv* env, 
jclass clazz, 
jlong avi) 


Instance* instance = 0; 


long frameSize = AVI frame size((avi t*) avi, 0); 
if (0 >= frameSize) 
{ 
ThrowException (env, "java/io/RuntimeException", 
"Unable to get the frame size."); 
goto exit; 


instance = new Instance(); 
if (0 == instance) 
{ 
ThrowException (env, "java/io/RuntimeException", 
"Unable to allocate instance."); 
goto exit; 


instance->buffer = (char*) malloc (frameSize); 
if (0 == instance->buffer) 
{ 
ThrowException(env, "java/io/RuntimeException", 
"Unable to allocate buffer."); 
delete instance; 
instance = 0; 


exit: 
return (jlong) instance; 


void Java com apress aviplayer OpenGLPlayerActivity initSsurfacel( 
JNIEnv* env, 
jclass clazz, 
jlong inst, 
jlong avi) 


Instance* instance = (Instance*) inst; 


// 启用 纹理 
glEnable (GL TEXTURE 2D); 


// 生成 一 个 纹理 对 象 


glGenTextures(1, &instance->texture); 
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// 绑 定 到 生成 的 纹理 上 


glBindTexture (GL TEXTURE 2D, instance->texture); 


int frameWidth = AVI video width((avi t*) avi); 
int frameHeight = AVI video height ((avi t*) avi); 


// 剪 切 纹理 矩形 
GLint rect[] = {0, frameHeight, frameWidth, -frameHeight}; 
glTexParameteriv (GL TEXTURE 2D, GL TEXTURE CROP RECT OES, rect); 


// 填 充 颜色 
glColor4f (1.0, 1.0, 1.0, 1.0); 


// 生 成 一 个 空 的 纹理 
glTexImage2D (GL_TEXTURE 2D, 
0, 
GL RGB, 
frameWidth, 
frameHeight, 
0 
GL_RGB, 
GL UNSIGNED SHORT 5 6 5, 
0); 


jboolean Java com apress aviplayer OpenGLPlayerActivity render( 
JNIEnv* env, 
jclass clazz, 
jlong inst, 
jlong avi) 


Instance* instance = (Instance*) inst; 
jboolean isFrameRead = JNI_FALSE; 
int keyFrame = 0; 


// 将 AVI 帧 字 节 读 至 bitmap 

long frameSize = AVI read frame ((avi t*) avi, 
instance->buffer, 
&keyFrame); 


// 检查 帧 是 否 读 了 
if (0 >= frameSize) 
{ 

goto exit; 


} 


// 读 帧 
isFrameRead = JNI_ TRUE; 
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// 使 用 新 帧 更 新 纹理 
glTexSubImage2D (GL TEXTURE 2D, 


AVI video width((avi t*) avi), 
AVI video height ((avi t*) avi), 
GL RGB, 

GL UNSIGNED SHORT 5 6 5, 
instance->buffer); 


// 绘制 纹理 
glDrawTexiOES(0, 0, 0, 
AVI video width((avi t*) avi), 
AVI video height((avi t*) avi)); 
exit;: 
return isFrameRead; 


void Java com apress aviplayer OpenGLPlayerActivity freel( 
JNIEnv* env, 
jclass clazz, 
jlong inst) 


Instance* instance = (Instance*) inst; 


if (0 != instance) 

{ 
free (instance->buffer); 
delete instance; 


} 
(20) 需要 修改 构建 文件 Android.mk 来 编译 新 的 源 文件 以 及 动态 链接 GLESv1_CM 共 
享 库 ， 从 而 可 以 使 用 原生 空间 的 OpenGL ES API， 如 程序 清单 12-28 所 示 。 


程序 清单 12-28 OpenGL Player 构建 文件 的 修改 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := AVIPlayer 

LOCAL SRC_FILES := \ 
Common.cpp \ 
com apress aviplayer AbstractPlayerActivity.cpp \ 
com apress aviplayer BitmapPlayerActivity.cpp \ 
com apress aviplayer OpenGLPlayerActivity .cpp 


# 使 用 AVILib 静态 库 
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LOCAL STATIC LIBRARIES += avilib static 


# 启用 GL ext 原型 


LOCAL CFLAGS += 一 DGL_GLEXT_ PROTOTYPES 


# 连接 OpenGL ES 
LOCAL LDLIBS += —1GLESv1 CM 


include $ (BUILD SHARED LIBRARY) 


(21) 现在 Bitmap Player activity 准备 好 了 。 想 要 使 用 它 的 话 ， 需 要 把 它 作 为 一 个 单 选 
按钮 添加 到 activity_main.xml 布局 文件 中 ， 如 程序 清单 12-29 所 示 。 


程序 清单 12-29 将 OpenGL Player 单 选 按钮 添加 到 Main 布局 中 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent" 
android:orientation="vertical" > 


<RadioGroup 
android:id="@+id/player radio group" 
android:layout width="wrap_content" 
android:layout height="wrap content" > 


<RadioButton 
android:id="@+id/bitmap player radio" 
android:layout width="wrap_content" 
android:layout height="wrap_content" 
android:checked="true" 
android:text="@string/bitmap player radio" /> 

<RadioButton 
android:id="@+id/open gl player radio" 
android:layout width="wrap_content" 
android:layout height="wrap content" 
android:text="@string/open gl player radio" /> 


</RadioGroup> 


</LinearLayout> 
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(22) main activity 的 源 代码 也 需要 修改 ， 如 程序 清单 12-30 所 示 ， 当 用 户 选择 时 ， 需 要 
向 Bitmap Player activity 发 送 播 放 请 求 。 


程序 清单 12-30 ”将 OpenGL Player 单 选 按钮 事件 添加 到 Main Activity 中 


* 在 播放 按钮 上 单 击 事件 处 理 . 
be 
private void onplayButtonClick() { 


// 基于 id 选 择 activity 

switch (radioId) { 

case R.id.bitmap player radio: 
intent = new Intent (this, BitmapPlayerActivity.class); 
break; 


case R.id.open gl player radio: 
intent = new Intent(this, OpenGLPlayerActivity.class); 
break; 


default: 
throw new UnsupportedOoperationException("radioId=" + radioId); 


} 


} 


(23) 现在 ，AVI player 应 用 程序 的 OpenGL ES 演 染 器 准备 好 了 。 采 用 和 本 章 JNI 
Graphics API 一 节 一 样 的 步骤 在 Android 模拟 器 上 运行 示例 应 用 程序 。 


12.5 ”使 用 原生 Window API 进行 泻 染 


从 Android API level 9 开始 ，Android NDK 提供 了 一 个 API 启用 原生 代码 来 直接 访问 
和 处 理 原生 window 的 像素 缓存 。 这 个 API 称 为 原生 window API。 本 节 将 学 习 如 何 使 用 这 
个 API 直接 在 原生 代码 中 进行 泻 染 而 无 须 引用 任何 基于 Java 的 API。 


12.5.1 启用 原生 Window API 


执行 以 下 步骤 在 应 用 程序 中 使 用 原生 Window API。 
(1) 包含 原生 window 头 文件 。 


#include <android/native _ window-h> 
#include <android/native window jni.h> 


(2) 修改 Android.mk 构建 文件 来 动态 链接 android 库 。 
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LOCAL LDLIBS += -landroid 


做 了 以 上 修改 后 ， 原 生 应 用 程序 中 就 可 以 使 用 原生 window API 了 。 
12.5.2 ”使 用 原生 Window API 


原生 Window API 提供 了 4 个 原生 函数 用 于 访问 和 操作 Bitmap 对 象 。 
1. 从 Surface 对 象 中 检索 原生 window 
ANativeWindow fromSurface 函数 可 以 从 给 定 的 Surface 对 象 中 检索 原生 window。 


ANativeWindow* ANativeWindow fromSurface (JNIEnv* enVv 
jobject surface); 


它 的 参数 为 一 个 JNIEnv 接口 指针 和 一 个 Surface 对 象 引 用 ， 返 回 值 是 一 个 指向 原生 
window 实例 的 指针 。ANativeWindow_fromSurface 同时 获得 了 返回 的 原生 window 实例 的 
引用 ， 为 了 防止 内 容 泄 露 ， 需 要 使 用 ANativeWindow_release 函数 来 释放 掉 。 


2. 获取 原生 Window 实例 中 的 引用 


为 了 防止 原生 window 实例 被 删除 , 原生 代码 可 以 使 用 ANativeWindow_acquire 函数 来 
获取 它 的 引用 。 


void ANativeWindow acquire (ANativeWindow* window); 

任何 ANativeWindow_acquire 函数 调用 都 要 对 应 一 个 ANativeWindow_release 函数 的 
调用 。 

3. 释放 原生 Window 引用 


如 上 所 述 ,为 了 防止 内 存 泄露 , 每 个 原生 window 的 引用 都 应 该 使 用 ANativeWindow 
release 函数 来 进行 释放 。 


void ANativeWindow release (ANativeWindow* window) 7 


ANativeWindow_release 的 参数 为 一 个 原生 window 实例 指针 。 
4. 检索 原生 Window 信息 


原生 Window API 为 原生 代码 提供 了 获取 很 多 有 关 原 生 window 信息 的 函数 ， 例 如 大 
小 和 像素 格式 。 

e ANativeWindow_getWidth 函数 用 于 检索 原生 window 的 宽度 。 

。 ANativeWindow_getHeight 函数 用 于 检索 原生 window 的 高 度 。 

。 ANativeWindow_getFormat 函数 用 于 检索 原生 window 的 像素 格式 。 


5. 设置 原生 window 缓冲 区 的 几何 形状 
原生 window 的 大 小 和 像素 格式 应 该 与 即将 泻 染 的 图 像 数 据 匹 配 。 如 果 图 像 数 据 的 大 
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小 或 者 像素 格式 不 一 致 , 可 以 用 ANativeWindow_setBuffersGeometry 函数 来 重新 配置 原生 
window 缓冲 区 。 这 样 缓冲 区 就 会 自动 缩放 来 匹配 原生 window。 
int32 t ANativeWindow setBuffersGeometry (ANativeWindow* window, 
int32 t width, 
int32 t height, 
int32 t format); 
该 函数 的 参数 为 前 面 获得 的 原生 window 实例 的 指针 、 原 生 window 缓冲 区 的 新 宽度 、 
高 度 以 及 新 的 像素 格式 。 成 功 的 话 ， 会 返回 0。 对 于 所 有 参数 ， 如 果 提供 的 值 为 0， 那么 参 
数值 将 被 恢复 到 原生 window 缓冲 区 的 基础 值 。 


6. 访问 原生 window 缓冲 区 


ANativeWindow_lock 函数 用 来 锁定 原生 window 缓冲 区 并 获得 一 个 原始 像素 缓冲 区 的 
指针 。 然 后 ， 原 生 代码 可 以 使 用 这 个 指针 来 访问 和 操作 像素 缓冲 区 。 
int32 t ANativeWindow lock (ANativeWindow* window, 
ANativeWindow Buffer* outBuffer, 
ARect* inOutDirtyBounds) 7 
该 函数 的 参数 是 前 面 获得 的 原生 window 实例 的 指针 、 指 向 ANativeWindow Buffer 结 
构 体 的 指针 以 及 指向 可 选 ARect 结构 体 的 指针 。 如 程序 清单 12-31 所 示 ，ANativeWindow_ 
Buffer 结构 体 除 了 拥有 原生 window 的 相关 信息 外 ， 还 可 以 通过 位 字段 来 访问 原生 像素 组 
冲 区 。 


程序 清单 12-31 ANativeWindow_Buffer 结构 体 声明 


typedef struct ANativeWindow Buffer { 
// 水 平 显 示 的 像素 数 . 
int32 t width; 


// 垂直 显示 的 像素 数 
int32 t height; 


// 缓冲 区 在 内 存 中 一 行 的 像素 数 ， 可 能 >= width. 
int32 t stride; 


// 缓冲 区 的 格式 . 如 : WINDOW_FORMAT * 


int32 七 format 7 


// 实际 位 数 . 


void* bits; 
// 不 要 碰 
uint32 t reserved[6]; 


} ANativeWindow Buffer; 


ANativeWindow_lock 函数 执行 成 功 的 话 会 返回 0。 
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7. 释放 原生 window 缓冲 区 


一 旦 原生 代码 完成 , 应 该 使 用 ANativeWindow_unlockAndPost 函数 解锁 并 输出 原生 
window 缓冲 区 。 


int32 t ANativeWindow unlockAndPost (ANativeWindow* window); 


该 函数 的 参数 是 一 个 已 经 被 锁定 的 原生 window 实例 指针 。 成 功 的 话 ， 返 回 0。 现 在 ， 
可 以 更 新 AVIPlayer 测试 应 用 程序 使 用 原生 window 泻 染 嚣 来 测试 这 些 函数 。 


12.5.3 用 原生 window 泻 染 器 来 更 新 AVI Player 


执行 以 下 步骤 。 
(1) 打开 Project Explorer， 打 开 AndroidManifestxml 清单 文件 并 声明 新 的 Activity， 如 
程序 清单 12-32 所 示 。 


程序 清单 12-32 ”在 清单 文件 中 声明 新 的 原生 window Player 


<manifest xmlns:android="http://schemas .android.com/apk/res/android" 
package="com.apress.aviplayer" 
android:versionCode="1" 
android:versionName="1.0" > 


<application 
android:icon="@drawable/ic launcher" 
android:1label="@string/app_name" 
android:theme="@style/AppTheme" > 


<activity 
android:name=" .OpenGLPlayerActivity" 
android:label="@string/title activity open gl player" > 
</activity> 
<activity 
android:name=".NativeWindowPlayerActivity" 
android:1label="@string/ title activity native window player" > 
</activity> 
</application> 


</manifest> 


(2) 和 Bitmap Player 单 选 按钮 一 样 , 新 的 Bitmap Player activity 的 标题 应 该 添加 到 字符 
串 资源 文件 中 。 打开 strings.xml 字符 串 资源 文件 并 添加 新 的 字符 串 资源 , 如 程序 清单 12-33 
所 示 。 
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程序 清单 12-33 ”添加 原生 window Player Activity 字符 串 资源 


<resources> 


<string name="title activity native window player" 
> 原生 window Player</string> 

<string name="native window player radio" 
> 原生 window Player</string> 


</resources> 


(3) Bitmap Player activity 想 要 运行 的 话 ， 需 要 一 个 单独 的 SurfaceView 小 控件 。 打 开 
Project Explorer， 展 开 res 目录 。 

(4) 右 击 layout 子 目录 ， 在 上 下 文 菜单 中 选择 New | File。 

(5) 将 File Name 设置 为 activity_native_ window_playerxml。 

(6) 用 程序 清单 12-34 的 内 容 和 替换 新 的 布局 文件 的 内 容 。 


程序 清单 12-34 _ activity_native_window_player.xml 布局 文件 的 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match Parent" 
android:layout height="match parent" > 


<SurfaceView 
android:layout width="match parent" 
android:layout height="match parent" 
android:id="@+id/surface view" /> 


</LinearLayout> 


(7) 打开 Project Explorer， 展 开 src 目录 。 

(8) 右 击 com.apress.aviplayer 包 ， 在 上 下 文 菜单 中 选择 New | Class。 
(9) 将 Name 设置 为 NativeWindowPlayerActivity。 

(10) 单 击 Finish 按钮 来 创建 新 的 类 。 

(11) 用 程序 清单 12-35 的 内 容 蔡 换 它 的 内 容 。 


程序 清单 12-35 ”OpenGLPlayerActivity.java 源 文件 的 内 容 
package com.apress.aviplayer; 

import java.util.concurrent.atomic.AtomicBoolean; 
import android.os.Bundle; 

import android.view.Surface; 


import android.view.SurfaceHolder; 
import android.view.SurfaceHolder.Callback; 


294 


图 形 API 


import android.view.SurfaceView; 


/** 
* 使 用 原生 窗口 的 AVI 播放 器 


入 

* @author Onur Cinar 

# 

public class NativeWindowPlayerActivity extends RbstractPlayerRctivity { 
/** 正在 播放 */ 


private final AtomicBoolean isPlaying = new AtomicBoolean(); 


/xx Surface 存储 器 . */ 
private SurfaceHolder surfaceHolder; 


/** 

* On create. 

太 

* @param savedInstanceState saved state. 

Sr 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState) 
setContentView(R.layout.activity bitmap player); 


SurfaceView surfaceView = (SurfaceView) 
findViewById(R.id.surface view); 


surfaceHolder = surfaceView.getHolder(); 
surfaceHolder.addCcallback (surfaceHolderCallback); 


/** 
* Surface holder 监听 surface 事件 的 回调 
s% 
private final Callback surfaceHolderCallback = new Callback() { 
public void surfaceChanged (SurfaceHolder holder, int format, 
int width, 
int height) { 


public void surfaceCreated(SurfaceHolder holder) { 
// surface 准备 好 后 开始 播放 


isPlaying.set (true); 


// 在 一 个 单独 的 线程 中 启动 泻 染 器 


new Thread (renderer) .start (); 


public void surfaceDestroyed(SurfaceHolder holder) { 
//surface 销毁 时 停止 播放 


isPlaying.set (false); 
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] 


/六 太 
* 泻 染 线程 通过 一 个 bitmap 将 AVI 文件 中 的 视频 帧 泻 染 到 surface 上 
sn 

private final Runnable renderer = new Runnable() { 

public void run() { 
// 获 得 surface 实例 


Surface surface = surfaceHolder.getSurface(); 


// 初 始 化 原生 window 


init(avi, surface); 


// 使 用 帧 速 计算 延迟 
long frameDelay = (long) (1000 / getFrameRate (avi) ) 7 


// 播 放 时 开始 泻 染 
while (isPlaying.get()) { 
// 将 帧 泻 染 至 surface 


render (avi, surface); 


// 等 待 下 一 帧 

try { 
Thread.sleep (frameDelay); 

} catch (InterruptedException e) { 
break; 


}; 


/** 
* 初 始 化 原生 window 


* @param avi file descriptor. 

* @param surface surface instance. 

a 

private native static void init(long avi, Surface surface); 


A 千 
将 给 定 AVI 文件 的 帧 泻 染 到 给 定 的 surface 上 


@param avi file descriptor. 

Qparam surface surface instance. 

Qreturn true if there are more frames, false otherwise. 

x, 

private native static boolean render(long avi, Surface surface); 


二 了 
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(12) 从 主 菜单 中 选择 Project | Build Project 来 编译 Java 源 代 码 。 

(13) 打开 Project Explorer， 选 择 NativeWindowPlayerActivity。 

(14) 在 主 菜 单 中 选择 Run | External Tools | Generate C and C++ Header File 对 Native- 
WindowPlayerActivity 类 调用 javah 工具 。 

(15) 在 项 目的 jni 子 目 录 下 ，javah 工具 会 生成 com_apress_aviplayer NativeWindow- 
PlayerActivity.h 头 文件 。 

(16) 右 击 jni 目录 ， 在 上 下 文 菜单 中 选择 New | Source File。 

(17) 将 Source File 设置 为 com_apress_aviplayer NativeWindowPlayerActivity.cpp。 

(18) 单 击 Finish 按钮 创建 一 个 新 的 C++ 源 文件 。 

(19) 打开 Eclipse， 用 程序 清单 12-36 的 内 容 替 换 新 的 源 文 件 的 内 容 。 


程序 清单 12-36 ”com_apress_aviplayer_NativeWindowPlayerActivity.cpp 的 内 容 


extern "C" { 
#include <avilib.h> 


} 


#include <android/native window jni.h> 
#include <android/native window.h> 


#include "Common.h" 
#include "com apress aviplayer NativeWindowPlayerActivity.h" 


void Java_ com apress aviplayer NativeWindowPlayerActivity init( 
JNIEnv* env, 
jclass clazz, 
jlong avi, 
jobject surface) 


// 从 surface 中 获得 原生 window 
ANativeWindow* nativeWindow = ANativeWindow fromSurface( 
env, surface); 
if (0 == nativeWindow) 
{ 
ThrowException(env, "java/io/RuntimeException", 
"Unable to get native window from surface."); 
goto exit; 


} 


// 设 置 Buffer 大 小 为 AVI 视频 帧 的 分 辩 率 

// 如 果 和 window 的 物理 大 小 不 一 致 

// Buffer 会 被 缩放 来 匹配 这 个 大 小 

if (0 > ANativeWindow setBuffersGeometry (nativeWindow, 
AVI video width((avi t*) avi), 
AVI video height((avi t*) avi), 
WINDOW_FORMAT RGB 565)) 


ThrowException (env, "java/io/RuntimeException"™", 
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"Unable to set buffers geometry."); 


// 释 放 原生 window 
ANativeWindow release (nativeWindow); 
nativeWindow = 0; 


oxits 
return; 


jboolean Java com apress aviplayer NativeWindowPlayerActivity render( 
JNIEnv* env, 
jclass clazz, 
jlong avi, 
jobject surface) 


jboolean isFrameRead = JNI_ FALSE; 


long frameSize = 0; 
int keyFrame = 0; 
// 从 surface 中 获取 原生 window 
ANativeWindow* nativeWindow = ANativeWindow fromSurface( 
env, surface); 
if (0 == nativeWindow) 
{ 
ThrowException (env, "java/io/RuntimeException", 
"Unable to get native window from surface."); 
goto exit; 


} 
// 锁 定 原生 window 并 访问 原始 Buffer 


ANativeWindow Buffer windowBuffer; 
if (0 > ANativeWindow lock (nativeWindow, &windowBuffer, 0)) 
a 
ThrowException(env, "java/io/RuntimeException", 
"Unable to lock native window."); 
goto release; 


t 
// 将 RVI 帧 的 比特 流 读 至 原始 缓冲 区 


frameSize = AVI read frame((avi tx*) avi, 
(char*) windowBuffer.bits, 
&keyFrame); 


// 检查 帧 是 否 被 成 功 读 取 


if (0 < frameSize) 
{ 
isFrameRead = JNI_ TRUE; 
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} 


// 解锁 并 且 输 出 缓冲 区 来 显示 


if (0 > ANativeWindow unlockAndPost (nativeWindow)) 
{ 
ThrowException (env, "java/io/RuntimeException", 
"Unable to unlock and post to native window."); 
goto release; 


} 


release: 
// 释 放 原 生 window 
ANativeWindow release (nativeWindow); 
nativeWindow = 0; 


exit: 
return isFrameRead; 


} 


(20) 需要 修改 构建 文件 Android.mk 编译 新 的 源 文件 以 及 动态 链接 android 共享 库 ， 从 
而 使 用 原生 window API， 如 程序 清单 12-37 所 示 。 


程序 清单 12-37 ”原生 window Player 构建 文件 的 修改 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := AVIPlayer 

LOCAL SRC FILES := \ 
Common.cpp \ 
com apress aviplayer AbstractPlayerActivity.cpp \ 
com apress aviplayer BitmapPlayerActivity.cpp \ 
com apress aviplayer OpenGLPlayerActivity.cpp \ 
com apress aviplayer NativeWindowPlayerActivity.cpp 


# 连接 Android 库 
LOCAL LDLIBS += —landroid 


include $ (BUILD SHARED LIBRARY) 


(21) Bitmap Player activity 现在 就 准备 好 了 。 想 要 使 用 它 的 话 ， 需 要 把 它 作 为 一 个 单 选 
按钮 添加 到 activity_main xml 布局 文件 中 ， 如 程序 清单 12-38 所 示 。 
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程序 清单 12-38 ”将 原生 window Player 单 选 按钮 添加 到 Main 布局 中 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:layout width="match parent" 
android:layout height="match parent™" 
android:orientation="vertical" > 


<RadioGroup 
android:id="@+id/player radio group" 
android:layout width="wrap content" 
android:layout height="wrap content" > 


<RadioButton 
android:id="@+id/open gl player radio" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:text="@string/open gl player radio" /> 


<RadioButton 
android:id="@+id/ native window player radio" 
android:layout width="wrap_content" 
android:layout height="wrap_ content" 
android:text="@string/native window player radio" /> 


</RadioGroup> 


</LinearLayout> 


(22) main activity 的 源 代码 也 需要 修改 ， 如 程序 清单 12-39 所 示 ， 当 用 户 选择 时 ， 需 要 
向 Bitmap Player activity 发 送 播放 请 求 。 


程序 清单 12-39 ”原生 window Player 单 选 按钮 事件 添加 到 Main Activity 中 


/#*# 
* 在 播放 按钮 上 单 击 事件 处 理 器 

“yf 

private void onPlayButtonClick() { 


// 基于 id 选 择 activity 
Switch (radioId) { 
case R.id.bitmap player radio: 
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intent = new Intent (this, BitmapPlayerActivity.class); 
break; 


case R.id.open gl player radio: 
intent = new Intent (this, OpenGLPlayerActivity.class); 
break; 


Case R.id.native window player radio: 
intent = new Intent(this, NativeWindowPlayerActivity.class); 
break; 


default: 
throw new UnsupportedOperationException("radioId=" + radioId); 


} 


} 


(23) 现在 ，AVI player 应 用 程序 的 原生 window 泻 染 器 准备 好 了 。 采 用 和 本 章 “JNI 
Graphics API” 一 节 一 样 的 步骤 在 Android 模拟 器 上 运行 示例 应 用 程序 。 


12.5.4 ”EGL 图 形 库 


从 API Level 9 开始 ，Android NDK 也 支持 EGL 图 形 库 ， 可 以 用 原生 应 用 程序 来 管理 
OpenGL ES surface。 更 多 关于 EGL 的 信息 可 以 在 Khronos Group 网 站 www.khronos.org/egl 
上 查询 到 。 

想 要 启用 EGL 图 形 库 ， 执 行 以 下 步 又 : 

(1) 包含 EGL 头 文件 。 


#include <EGL/egl.h> 
#include <EGL/eglext.h> 


(2) 修改 Android.mk 构建 文件 来 动态 链接 EGL 库 。 
LOCAL LDLIBS += -1lEGL 


通过 这 些 修改 , 现在 可 以 在 你 的 原生 应 用 程序 中 使 用 EGL 图 形 库 了 。 你 可 以 使 用 EGL 
图 形 库 API 函数 来 列 出 所 支持 的 EGL 配置 、 分 配 和 释放 OpenGL ES surface 以 及 用 来 显示 
的 交换 / 单 击 surface。 


12.6 ”小结 
本 章 探讨 了 原生 应 用 程序 可 用 的 不 同 原生 图 形 API。 本章 通 篇 构建 了 一 个 AVI 视频 播 
放 器 应 用 程序 来 让 我 们 更 好 地 理解 这 些 原生 图 形 API。 
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在 第 12 章 中 ， 我 们 已 经 体会 到 Android 平台 提供 的 原生 图 形 API 的 多 姿 多 彩 。 从 
Android 操作 系统 2.3 版 本 API level 9 开始 ，Android 平台 也 提供 一 系列 原生 音频 API， 使 
得 原生 代码 可 以 方便 地 播放 及 记录 音频 而 无 须 调用 Java 层 的 任何 函数 。Android 原生 音频 
支持 基于 由 Khronos Group 提供 的 OpenSL ES 1.0.1 标准 .OpenSL ES 是 Open Sound Library 
for Embedded Systems 的 缩写 。 本 章 我 们 将 简要 介绍 与 Android 平台 有 关 的 OpenSL ES 原 
生 音 频 API。 


13.1 使 用 OpenSL ES API 


鉴于 OpenSL ES 规范 庞大 ， 本 章 将 只 涉及 有 关 Android 平台 的 部 分 。 关 于 OpenSL ES 更 
多 的 信息 可 以 在 SANDROID_NDK_HOME/docs/opensles/OpenSL ES_Specification 1.0.1.pdf 
中 找到 。 

(1) OpenSL ES API 通过 一 系列 头 文件 展示 。 需 要 被 包含 的 主要 头 文件 是 SLES/Open- 
SLESh。 


#include <SLES/OpenSLES .h> 


(2) 为 了 使 用 Android 的 扩展 功能 ， 源 文件 中 也 同样 应 该 包含 头 文件 SLES/ 
OpenSLES_Android.h 。 


#include <SLES/OpenSLES_RAndroid.h> 


(3) OpenSL ES 原生 音频 API 也 需要 有 与 原生 模块 动态 链接 的 库 文件 。 这 可 以 通过 在 
Android.mk 构建 脚本 中 添加 如 下 代码 实现 : 


LOCAL IDLIBS += -LOpenSLES 


Android 平台 对 于 使 用 OpenSL ES 的 应 用 程序 是 二 进 制 兼容 的 。 只 需要 简单 链接 共享 
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库 文件 ， 同 样 的 应 用 程序 即 可 在 提供 该 特性 的 平台 上 无 缝 运行。 
13.1.1 与 OpenSL ES 标准 的 兼容 性 


尽管 基于 OpenSL ES 1.0.1 规范 , 但 Android 原生 音频 API 并 没有 遵循 任何 OpenSL ES 
文件 的 实现 。 在 实现 中 与 Android 相关 的 部 分 通过 调用 Android Extensions API 展示 。 更 多 
关于 Android Extensions 的 信息 请 参阅 Android NKD 文档 , 其 路 径 如 下 : SANDROID_NDK_ 
HOME/docs/opensles/index.html。 


13.1.2 ”音频 许可 


在 音频 许可 方面 ， 使 用 原生 音频 API 与 使 用 基于 Java 的 音频 API 没有 任何 区 别 。 应 
用 程序 需要 在 清单 文件 中 使 用 usespermission 标签 申请 获取 适当 的 许可 。 
e 需要 包含 android.permission.RECORD_AUDIO 以 便 创建 一 个 音频 录音 机 。 
e 需要 包含 android.permission.MODIFY_AUDIO_SETTINGS 以 便 改变 音频 设置 及 使 
用 音效 。 


13.2 创建 WAVE 音频 播放 器 


WAVE 音频 播放 器 应 用 程序 将 作为 测试 平台 来 演示 Android 平台 上 基于 OpenSL ES 的 
原生 音频 播放 ， 示 例 应 用 程序 将 提供 以 下 内 容 : 

e 支持 原生 代码 的 Android 应 用 程序 项 目 。 

e 在 原生 代码 中 解析 WAVE 音频 文件 的 静态 链接 WAVE 库 文 件 。 

e 支持 基于 OpenSL ES 的 WAVE 音频 文件 播放 。 

e 从 SD 卡 中 指定 要 播放 的 WAVE 文件 的 简单 GUI。 

播放 WAVE 音频 文件 需要 解析 WAVE 文件 。 虽 然 WAVE 格式 并 不 十 分 复杂 ， 但 为 方 
便 起 见 ， 我 们 会 用 一 个 第 三 方 WAVE 库 文件 来 处 理 WAVE 文件 。 


注意 : 
关于 此 示例 应 用 程序 的 全 部 源 代码 可 以 从 出 版 商 的 网 站 上 下 载 : www.apress.com。 


13.2.1 将 WAVELib 作为 NDK 导入 模块 


第 10 章 所 用 到 的 AVILib 库 文件 也 是 通过 WAVELib 提供 对 WAVE 音频 文件 的 支持 。 
通过 以 下 步骤 将 WAVELib 添加 为 NDK 导入 模块 。 

(1) 如 果 使 用 Mac OS 或 者 Linux 系统 则 打开 一 个 终端 窗口 ， 如 果 用 Windows 系统 请 
打开 Cygwin。 

(2) 输入 以 下 命令 , 将 当前 目录 改 为 AVILib( 在 第 10 章 中 已 经 安装 ) 的 Android NDK 导 
入 模块 目录 。 


cd $ANDROID NDK HOME/sources/transcode-1.1.5/avilib 
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G) 在 Eclipse 中 打开 Android.mk 构建 脚本 。 参 照 程序 清单 13-1, 为 静态 和 共享 WAVELib 
库 文 件 添加 导入 模块 描述 。 


程序 清单 13-1 包含 WAVELib 导入 模块 的 Android.mk 构建 文件 


LOCAL PATH := $(call my-dir) 


# 
# 转 码 WAVLib 
# 


# 源 文件 
MY WAVLIB SRC FILES := wavlib.c Platform posix.c 


# 包 含 导 出 目录 
MY_WAVLIB C_INCLUDES := $ (LOCAL PRTH) 


捍 

# WAVLib 静态 

捍 

include $ (CLEAR VARS) 


# 模块 名 称 


LOCAL MODULE := wavlib static 


# 源 文件 
LOCAL SRC FILES := $(MY WAVLIB SRC FILES) 


# 包 含 导 出 目录 
LOCAL EXPORT C INCLUDES := $(MY_WRVLIB_C_INCLUDES) 


# 构建 静态 库 
include $ (BUILD STATIC LIBRARY) 


# 

# WAVLib 共享 

## 

include $ (CLEAR VARS) 


# 模块 名 称 
LOCAL MODULE := wavlib shared 


# 源 文件 
LOCAL SRC FILES := $(MY WAVLIB SRC FILES) 


# 包 含 导 出 目录 
LOCAL EXPORT C INCLUDES := $(MY_WRVLIB C_INCLUDES) 
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# 构建 共享 库 

include $(BUILD_SHARED LIBRARY) 

通过 以 上 修改 ， 原 生 模 块 可 以 将 WAVELib 作为 静态 和 共享 库 使 用 。WAVELib 现 已 可 
用 于 WAVE 播放 器 应 用 程序 。 


13.2.2 创建 WAVE 播放 器 Android 应 用 程序 


为 创建 WAVE 播放 器 应 用 程序 ， 打开 New Android Application Project 对 话 框 ， 执 行 以 
下 步骤 。 

(1) 将 Application Name 设置 为 WAV Player。 

(2) 将 Project Name 设置 为 WAV Player。 

(3) 将 Package Name 设置 为 com.apress.wavplayer。 

(4) 单 击 Next 按钮 接受 当前 及 后 续 向 导 页 面 中 的 默认 值 。 

(5) 当 Android 应 用 程序 项 目 创建 之 后 ， 使 用 Project Explorer， 通 过 Android Tools 弹 
出 式 菜单 打开 Add Android Native Support 向 导 。 

(6) 将 Library Name 设置 为 WAVPlayer。 

(7) 单 击 Finish 按钮 为 新 项 目 添加 原生 支持 。 


13.2.3 创建 WAVE 播放 器 主 Activity 


主 activity 将 提供 一 个 简单 的 GUI 指定 从 SD 卡 中 选择 要 进行 播放 的 WAVE 音频 文件 。 
按 如 下 步骤 完成 该 主 Activity: 

(1) 使 用 Project Explorer 展开 res 目录 资源 。 打 开 values 子 目录 下 string.xml 文件 ， 填 
充 字 符 串 资 源 ， 并 参照 程序 清单 13-2 替换 文件 内 容 。 


程序 清单 13-2 ”res/values/string.xml 字符 串 资源 文件 内 容 


<resources> 
<string name="app_name">WAV Player</string> 
<string name="menu settings">Settings</string> 
<string name="title activity main">MainActivity</string> 
<string name="file name hint">WAV file</string> 
<string name="play button">Play</string> 
<string name="error alert title">Error Occurred</string> 
<string name="file name">8kl6bitpcm.wav</string> 
</resources> 


(2) 该 主 activity 提供 一 个 含有 文本 域 的 简单 GUI 来 指定 WAVE 音频 文件 名 ， 并 通过 
Play 按钮 在 原生 代码 中 使 用 OpenSL ES 的 启动 播放 功能 。 使 用 Project Explorer， 展 开 res 
资源 目录 下 layout 子 目录 。 打 开 activity_main.xml 布局 文件 并 参照 程序 清单 13-3 替换 其 
内 容 。 
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程序 清单 13-3 ”res/layout/activity_main.xml 布局 文件 内 容 


<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
xmlns:tools="http://schemas.android.com/tools" 
android:id="@+id/LinearLayoutl" 
android:layout width="match parent" 
android:layout height="match parent™" 
android:orientation="vertical" > 


<EditText 
android:id="@+id/fileNameEdit" 
android:layout width="match parent" 
android:layout height="wrap_content" 
android:ems="10" 
android:hint="@string/file name hint" 
android:text="@string/file name" > 


<requestFocus /> 
</EditText> 


<Button 

android:id="@+id/playButton" 
:layout width="wrap_content" 
:layout height="wrap_content" 
android:text="@string/play_ button" /> 


</LinearLayout> 


(3) 现在 我 们 将 实现 该 主 activity。 该 主 activity 启动 异步 播放 任务 ， 并 通过 调用 play 
原生 函数 开启 指定 WAVE 音频 文件 的 播放 ， 该 函数 将 在 本 章 后 续 部 分 用 OpenSL ES 实现 。 
用 Project Explorer， 打 开 MainActivityjava 源 文件 ， 并 参照 程序 清单 13-4 替换 其 内 容 。 


程序 清单 13-4 ”MainActivity.java 源 文件 内 容 


package com.apress.wavplayer; 


import java.io.File; 
import java.io.IOException; 


import android.app.Activity; 

import android.app.AlertDialog; 

import android.os.AsyncTask; 

import android.os.Bundle; 

import android.os.Environment; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.EditText; 


/太太 


大 
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WAVE 播放 器 主 activity 

娘 

* Qauthor Onur Cinar 

六 六 

public class MainActivity extends Activity implements OnClickListener { 
/x+ 文件 名 编辑 文本 */ 


private EditText fileNameEdit; 


/** 
* On create. 
大 


* Q@param savedInstanceState 
* 保 存 当前 状态 
wd 
public void onCreate (Bundle savedInstancestate) { 
super.onCreate (savedInstanceState); 
setContentView(R.layout.activity main); 


fileNameEdit = (EditText) findViewById(R.id.fileNameEdit); 
Button playButton = (Button) findViewById(R.id.playButton); 
playButton.setOonClickListener (this); 


/** 
* 单 击 
* Q@param view 
* 视图 实例 
a 
public void onClick(View view) { 
switch (view.getId()) { 
case R.id.playButton: 
onPlayButtonClick(); 


/*# 
* 单 击 播放 按钮 
本 
Private void onPlayButtonClick() { 
// 位 于 外 部 存储 器 
File file = new File(Environment.getExternalStorageDirectory()， 
fileNameEdit.getText () .toString()) 7 


// 开 始 播放 
PlayTask playTask = new PlayTask(); 
playTask.execute (file.getAbsolutePath ()); 
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WE 
private class PlayTask extends AsyncTask<String, Void, Exception> { 
/*# 
* 后 台 播 放任 务 
* @param file 
*WAVE 文件 
有 
protected Exception doInBackground(string... file) { 
Exception result = null; 


trey { 
// 播 放 WAVE 文件 
play (file[0]); 

} catch (IOException ex) { 
result = ex; 


return result; 


/*#* 
* 执行 Post. 


大 
* @param ex 
* 异常 实例 . 
id 
protected void onPostExecute (Exception ex) { 
// 如 果 播放 失败 则 显示 错误 信息 
if (ex != null) { 
new AlertDialog.Builder (MainActivity.this) 
.setTitle(R.string.error alert title) 
.SetMessage (ex.getMessage ()) .show(); 


/太太 
大 


使 用 原生 API 播放 指定 的 WAVE 文件 


* Q@param fileName 
* 文件 名 . 
* @throws IOException 
Sf 
private native void play(String fileName) throws IOException; 


static { 
System.1loadLibrary ("WAVPlayer"); 
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现在 WAVE 播放 器 应 用 程序 的 Java 部 分 准备 好 了 。 现 在 需要 开始 实现 原生 Play 按钮 
以 通过 OpenSL ES 库 来 播放 指定 的 WAVE Audio 文件 。 


13.2.4 实现 WAVE Aduio 播放 


如 前 所 述 ， 我 们 实现 了 WAVE 音频 播放 器 应 用 程序 的 原生 部 分 ， 建 立 了 程序 的 Java 
部 分 并 确保 其 可 通过 编译 。 按 以 下 步骤 将 实现 播放 功能 。 

(1) 使 用 Project Explorer， 选 定 MainActivity.java 源 文件 并 从 主 菜单 栏 中 选择 Run | 
External Tools | Generate C and C++ header file 以 生成 com apress_wavplayer MainActivity.h 
头 文件 ， 该 头 文件 声明 了 原生 函数 。 

(2) 需要 修改 项 目的 Android.mk 构建 脚本 , 以 便 通 过 与 wavelib_static 库 文件 静态 链接 
来 获得 对 WAVE 文件 格式 的 支持 , 并 通过 与 OpenSL ES 库 文件 动态 链接 来 使 用 OpenSL ES 
原生 音频 API。 在 Eclipse 中 打开 构建 脚本 ， 参 照 程序 清单 13-5 替换 其 内 容 。 


程序 清单 13-5 jni/Android.mk 构建 脚本 内 容 
LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := WAVPlayer 
LOCAL SRC_FILES := WAVPlayer.cpp 


# 使 用 WAVLib 静态 库 
LOCAL STATIC LIBRARIES += wavlib static 


# 与 OpenSL ES 链接 
LOCAL LDLIBS += -1OpenSLES 


include $ (BUILD SHARED LIBRARY) 


# 引入 WAVLib 库 模块 


$(call import-module，transcode-1.1.5/avilib) 

(3) 在 Elipse 中 打开 WAVPlayer.cpp 原生 资源 文件 。 开 始 部 分 包含 必要 的 头 文件 以 使 
用 OpenSL ES API 和 WAVLib API， 如 程序 清单 13-6 所 示 。 

程序 清单 13-6 jni/WAVPlayer.cpp 源 文件 中 包含 的 头 文件 


#include "com apress wavplayer MainActivity.h" 


#include <SLES/OpensLES.h> 
#include <SLES/OpensLES Android.h> 


extern "C" { 
#include <wavlib.h> 


} 
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static const char* JAVA LANG IOEXCEPTION = "java/lang/IOEXCeption"7 
static const char* JAVA LANG OUTOFMEMORYERROR = 
"java/lang/OutOfMemoryError™"; 


#define ARRAY LEN(a) (sizeof(a) / sizeof(a[0])) 


(4) OpenSL ES 原生 音频 API 被 设计 为 以 异步 方式 运行 .在 整个 播放 过 程 中 , OpenSL ES 
引擎 将 调用 一 个 指定 的 回调 函数 来 提供 音频 数据 。 该 函数 需要 访问 播放 器 上 下 文 以 呈现 其 
功能 。PlayContext 结构 体 用 来 给 已 注册 的 回调 函数 提供 播放 器 上 下 文 。PlayerContext 保存 
有 OpenSL ES、WAVLib 结构 和 音频 缓冲 区 。 附 上 PlayerContext 的 源 文件 WAVPlayercpp 
如 程序 清单 13-7 所 示 。 


程序 清单 13-7 ”PlayerContext 结构 持 有 Native Context 


/** 

* Player context. 

*/ 

struct PlayerContext 

{ 
SLObjectItf engineObject; 
SLEngineItf engineEngine; 
SLObjectItf outputMixObject; 
SLObjectItf audioPlayerObject; 
SLAndroidSsimpleBufferQueueItf audioplayerBufferQueue; 
SLPlayItf audioPlayerPlay” 
WAV wav; 


unsigned char* buffer; 
size t bufferSize7 


PlayerContext () 

: engineObject (0) 

, engineEngine (0) 

,+ outputMixObject (0) 
audioPlayerBufferQueue (0) 
audioPlayerPlay (0) 

wav (0) 

buffersize(0) 


}; 
(5) ThrowException 作为 一 个 辅助 函数 ， 用 来 在 发 生 错误 时 方便 地 将 异常 抛 出 至 Java 
层 。 附 上 这 些 函 数 的 源 文件 ， 如 程序 清单 13-8 所 示 。 
程序 清单 13-8 ”ThrowException 辅助 函数 
/** 
* 从 给 定 的 类 和 消息 中 抛 出 异常 


太 
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* @param env JNIEnv interface. 
* @param className class name. 
* @param message exception message. 
Wy 
static void ThrowException( 
JNIEnv* env, 
const char* className, 
const char* message) 


// 获 取 异 常 类 


jclass clazz = env->FindClass (className); 


// 如 果 异 常 类 被 发 现 
if (0 != clazz) 
{ 

// 抛 出 异常 


env->ThrowNew (clazz, message); 


// 释放 类 引用 


env->DeleteLocalRef (clazz); 


} 


(6) OpenWaveFile 函数 打开 指定 的 WAVE 音频 文件 ， CloseWaveFile 函数 会 在 不 需要 该 
文件 时 将 其 释放 。 如 果 发 生 错 误 ， 这 两 个 函数 均 会 殷 出 IOException 通知 Java 应 用 程序 ， 
并 弹出 警告 对 话 框 来 提醒 用 户 。 附 上 这 些 函 数 的 源 文件 ， 如 程序 清单 13-9 所 示 。 


程序 清单 13-9 ”打开 和 关闭 WAVE 文件 的 WAVLib 辅助 函数 


女友 
* 打 开 给 定 的 WAVE 文件 


eparam env JNIEnv interface. 
@param fileName file name. 
Q@return WAV file. 

@throws IOException 


证 半 证 入 市 


“yf 

static WAV OpenWaveFilel( 
JNIENnV* env, 
jstring fileName) 


WAVError error = WAV_SUCCESS; 
WAV wav = 07 


// 以 c 字 符 串 形式 获取 文件 名 
const char* cFileName = env->GetSstringUTFChars (fileName, 0); 
if (0 == cFileName) 

goto exit; 


// 打 开 WAVE 文件 
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Wav = Wav open(cFileName, WAV READ, &error); 


// 释 放 文件 名 


env->ReleaseStringUTFChars (fileName, cFileName); 


// 错 误 检查 
if (0 == wav) 
' 
ThrowException (env, 
JAVA LANG IOEXCEPTION, 
wav_strerror (error)); 


} 


exit: 
return wav; 


} 


/** 
* 关 闭 给 定 的 WAVE 文件 


* @param wav WAV file. 
* @throws IOException 
static void CloseWaveFile( 
WAV wav) 
{ 
if (0 != wav) 
' 
wav_close (wav); 
站 
} 


(7) OpenSL ES 函数 调用 会 因为 多 种 原因 而 失败 。 每 一 个 OpenSL ES 函数 调用 会 返回 
SLresult 类 型 的 结果 码 。OpenSL ES 并 未 提供 任何 函数 将 这 些 结果 码 转换 为 可 读 信息 。 
ResultToString 辅助 函数 填补 了 该 空白 。 它 获取 结果 码 并 返回 相应 的 错误 信息 。 附 上 
ResultToString 函数 ， 如 程序 清单 13-10 所 示 。 


程序 清单 13-10 ”转换 结果 码 的 ResultToString 辅助 函数 


/太太 
大 


* 将 OpenSL ES 结果 转换 为 字符 串 


* Q@param result result code. 

* @return result string. 

六 站 

static const char* ResultToString(SLresult result) 
{ 


const char* str = 0; 
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switch (result) 

1 

Case SL RESULT SUCCESS: 
str = "Success"; 
break; 


Case SL RESULT PRECONDITIONS VIOLATED: 
str = "Preconditions violated"; 
break; 


Case SL RESULT PARAMETER INVALID: 
str "Parameter invalid"; 
break; 


case SL RESULT MEMORY FAILURE: 
str = "Memory failure"; 
break; 


case SL RESULT RESOURCE ERROR: 
str "Resource error"; 
break; 


case SL RESULT RESOURCE LOST: 
str = "Resource lost"; 
break; 


case SL RESULT IO ERROR: 
str = "IO error"; 
break; 


Case SL RESULT BUFFER INSUFFICIENT: 
str = "Buffer insufficient"; 
break; 


Case SL RESULT CONTENT CORRUPTED: 
str = "Success"; 
break; 


case SL RESULT CONTENT UNSUPPORTED: 
str "Content unsupported"; 
break; 


case SL RESULT CONTENT NOT_ FOUND: 
str = "Content not found"; 
break; 


Case SL RESULT PERMISSION DENIED: 


str = "Permission denied"; 
break; 
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Case SL RESULT _ FEATURE UNSUPPORTED: 
str = "Feature unsupported"; 
break; 


Case SL RESULT INTERNAL ERROR: 
str = "Internal error"7 
break; 


Case SL RESULT UNKNOWN ERROR: 
str = "Unknown error™; 
break; 


Case SL RESULT OPERATION ABORTED: 
str = "Operation aborted"; 
break; 


case SL RESULT CONTROL LOST: 
str = "Control lost"; 
break; 


default: 
str = "Unknown code"; 


return str; 


} 


(8) CheckError 辅助 函数 在 结果 码 指示 一 个 相应 的 错误 时 抛 出 一 个 IOException 异常 。 
它 使 用 ResultToString 函数 把 对 应 结果 码 转换 为 一 个 信息 。 附 上 CheckError 函数 ， 如 程序 
清单 13-11 所 示 。 


程序 清单 13-11 CheckError 函数 会 在 有 错误 的 时 候 抛 出 一 个 异常 


/* 和 
* 检 查 结果 是 否 出 错 ， 并 抛 出 含 错误 信息 的 IOException。 


* @param env JNIEnv interface. 

* @param result result code. 

* Q@return error occurred. 

* @throws IOException 

Sg 

static bool CheckError( 
JNIEnv* env, 
SLresult result) 


bool isError = false; 


// 如 果 发 生 错误 
if (SL RESULT SUCCESS != result) 
{ 
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// 抛 出 IOException 
ThrowException (env, 
JAVA LANG IOEXCEPTION, 
ResultToString (result)); 
isError = true; 
} 
return isError; 


站 

(9) 虽然 OpenSL ESAPI 是 基于 C 语言 的 ,但 它 采 用 面向 对 象 的 方法 实现 .每 个 OpenSL 
ES 的 结构 体 建立 在 两 个 主要 结构 之 上 : 对 象 和 接口 。 对 象 是 针对 定义 明确 的 任务 所 指定 的 
抽象 资源 集合 。 接 口 是 对 象 提供 的 相关 功能 的 抽象 集合 。 对 象 可 以 对 外 提供 一 个 或 多 个 接 
口 ， 对 象 可 通过 引擎 对 象 或 对 象 接口 创建 。 每 个 OpenSL ES 应 用 程序 应 首先 先 创建 一 个 引 
擎 对 象 ， 以 便 可 以 访问 其 他 API 函数 。 引 擎 通过 slCreateEngine API 创建 。CreateEngine 辅 
助 功能 用 该 函数 创建 引擎 对 象 并 在 其 失败 时 抛 出 IOException 异常 。 附 加 CreateEngine 函 
数 的 源 代码 ， 如 程序 清单 13-12 所 示 : 


程序 清单 13-12 ”创建 引擎 对 象 的 CreateEngine 函数 
/* 大 


* 创 建 openSL ES 引擎 


* @param env JNIEnv interface. 
* @param engineObject object to hold engine. [OUT] 
* @throws IOException 
Wi 
static void CreateEngine( 
JNIEnv* env, 
SLObjectItf& engineObject) 


// 
// android 中 openSL ES 被 设计 为 是 线程 安全 的 ， 
// 所 以 该 选项 请 求 将 被 忽略 ， 但 它 应 保证 源 代 码 可 被 移植 到 其 他 平台 
SLEngineOption engineOptions[] = { 
{ (SLuint32) SL _ ENGINEOPTION THREADSAFE, 
(SLuint32) SL BOOLEAN TRUE } 
}; 


// 创 建 openSL ES 引擎 对 象 

SLresult result = sl1CreateEngine( 
&engineObject, 
ARRAY LEN (engineOptions), 
engineOptions, 
0，// 没 有 接口 
0，// 没 有 接口 
0) ; // 无 须 提供 

// 错 误 检查 


CheckError (env, result); 
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(10) 对 象 一 经 创建 ， 便 处 于 未 实例 化 状态 ， 对 象 虽 已 存在 但 未 分 配 任何 资源 。 为 使 用 
该 对 象 须 先 将 其 实例 化 。 可 通过 Object 接口 提供 的 Realize 函数 来 完成 。RealizeObject 辅 
助 函 数 用 来 实现 对 象 并 在 自身 执行 失败 时 抛 出 一 个 IOException 异常 。 附件 该 函数 的 源 文 
件 ， 如 程序 清单 13-13 所 示 。 


程序 清单 13-13 ”实现 对 象 实例 RealizeObject 函数 


二 
大 


* 实 现 给 定 的 对 象 ，Object 在 使 用 前 应 该 先 被 实现 。 


* @param env JNIEnv interface. 
* @param object object instance. 
* @throws IOException 
be 
static void RealizeObject( 
JNIEnv* env, 
SLObjectItf object) 


// 实 现 该 引擎 对 象 
SLresult result = (*object)->Realize( 
object, 
SL BOOLEAN FALSE); // No async, blocking call 


// 错 误 检查 
CheckError (env, result); 


} 


(11) 当 不 再 需要 对 象 时 ， 要 将 其 销毁 以 释放 所 分 配 的 资源 。 可 以 通过 Object 接口 提供 
的 Destroy 函数 实现 。 附 上 DestroyObject 函数 的 源 代码 ， 如 程序 清单 13-14 所 示 。 


程序 清单 13-14 ”DestroyObject 函数 用 来 销毁 不 再 使 用 的 对 象 
/** 


灵 


* 销 毁 给 定 的 对 象 实例 


* @param object object instance. [IN/OUT] 
EF 
static void DestroyObject (SLObjectItf& object) 
{ 
if (0 != object) 
(*object)->Destroy (object); 


object = 0; 
} 


(12) 每 一 个 对 象 可 以 有 一 个 或 多 个 接口 。 这 些 接口 可 通过 Object 接口 提供 的 GetInterface 
函数 获得 。 该 GetEngineInterface 辅助 函数 从 给 定 的 Engine Object 中 获得 Engine Interface。 
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附 上 该 函数 的 源 文件 ， 内 容 如 程序 清单 13-15 所 示 。 


程序 清单 13-15 ”获得 Engine Interface 的 GetEnginelnterface 函数 
/** 
* 从 给 定 的 引擎 对 象 中 获得 引擎 接口 以 便 从 该 引擎 中 创建 其 他 对 象 。 


* @param env JNIEnv interface. 
* Q@param engineObject engine object. 
* @param engineEngine engine interface. [OUT] 
* @throws IOException 
* 
static void GetEngineInterface( 
JNIEnv* env, 
SLObjectItfg& engineObject, 
SLEngineItf& engineEngine) 


// 获 得 引擎 接口 
SLresult result = (*engineObject)->GetInterfacel( 
engineObject, 


SL_IID ENGINE, 
&engineEngine); 


// 误 检查 


CheckError (env, result); 


} 


(13) CreateOutputMix 函数 通过 调用 带 有 一 组 参数 的 Engine Interface 的 CreateOutputMix 
函数 来 创建 Output Mixer 对 象 . 附 上 CreateOutputMix 函数 的 源 文 件 ,内 容 如 程序 清单 13-16 
所 示 : 


程序 清单 13-16 “创建 Output Mixer 的 CreateOutputMix 函数 


/**# 
大 
* 创 建 和 输出 混合 对 象 


* @param env JNIEnv interface. 
* @param engineEngine engine engine. 
* @param outputMixObject object to hold the output mix. [OUT] 
* @throws IOException 
ed 
static void CreateOutputMix( 
JNIEnv* env, 
SLEngineItf engineEngine, 
SLObjectItf& outputMixObject) 


// 创 建 输出 混合 对 象 


SLresult result = (*engineEngine)->CreateOutputMix( 
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engineEngine, 
&outputMixObject, 
0，// 没有 接口 
0，// 没有 接口 

0); // 无 须 提 供 


// 错 误 检查 
CheckError (env, result); 


} 
(14) InitPlayerBuffer 辅助 函数 创建 一 个 字 节 缓冲 区 来 保存 音频 数据 块 ， 并 在 不 需要 该 
缓冲 区 时 用 FreePlayerBuffer 将 其 释放 。InitPlayerBuffer 函数 通过 WAVE 音频 文件 头 获取 


根 占用 缓冲 区 值 的 大 小 ， 该 值 根据 输入 文件 的 大 小 得 出 。 附 上 该 函数 的 源 代码 ， 如 程序 清 
单 13-17 所 示 : 


程序 清单 13-17 “InitPlayerBuffer 和 FreePlayerBuffer 辅助 函数 
/ 太太 


* 释 放 播放 器 缓冲 区 


* @param buffers buffer instance. [OUT] 
*y 
static void FreePlayerBuffer (unsigned char*& buffers) 
{ 
if (0 != buffers) 
所 
delete buffers; 
buffers = 0; 


} 
/* 大 
* 初 始 化 播放 器 缓冲 区 


* @param env JNIEnv interface. 
* @param wav WAVE file. 
* @param buffers buffer instance. [OUT] 
* @param bufferSize buffer size. [OUT] 
a 
static void InitPlayerBuffer( 

UNIEnVx* env, 

WAV wav, 

unsigned char*& buffer, 

size tg& bufferSize) 


// 计 算 缓冲 区 大 小 
bufferSize = wav get channels(wav) * wav get rate (wav) 
* wav_ get _ bits (wav); 
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// 初 始 化 buffer 
buffer = new unsigned char [bufferSize]7 
if (0 == buffer) 
{ 
ThrowException (env, 
JAVA LANG OUTOFMEMORYERROR, 
"buffer"); 


} 


(15) 为 了 通过 OpenSL ES 播放 WAVE 音频 文件 ， 需 要 使 用 带 有 缓冲 区 队列 的 音频 播 
放 器 。CreateBufferQueueAudioPlayer 函数 创建 一 个 简单 的 Android 缓冲 区 队列 ， 该 缓冲 区 
队列 只 有 一 个 buffers slots 作为 音频 源 .为 提高 质量 , 可 以 适当 选择 使 用 更 多 的 buffers slots。 
该 函数 根据 WAVE 音频 文件 头 的 结果 来 定义 PCM 播放 的 参数 。 音 频 播 放 器 的 输出 方式 被 
设置 为 Output Mixer。 附 上 该 函数 ， 内 容 如 程序 清单 13-18 所 示 : 


x 


程序 清单 13-18 ”CreateBufferQueueAudioPlayer 函数 


VA 

* 创 建 缓冲 区 队列 音频 播放 器 。 

和 

* @param wav WAVE file. 

* @param engineEngine engine interface. 

* @param outputMixObject output mix. 

* @param audiopPlayerObject audio player. [OUT] 
* @throws IOException 

二 

static void CreateBufferQueueAudioPlayer( 


WAV wav, 

SLEngineItf engineEngine, 
SLObjectItf outputMixObject, 
SLObjectItf& audioPlayerobject) 


// android 针对 数据 源 的 简单 缓冲 区 队列 定位 器 
SLDataLocator_RndroidSimpleBufferQueue dataSourceLocator = { 
SL_DATALOCATOR_ANDROIDSIMPLEBUFFERQUEUE，// 定位 器 类 型 

1 // 缓冲 区 数 
}; 


// PCM 数据 源 格式 
SLDataFormat PCM dataSourceFormat = { 
SL_DATAFORMAT_PCM，// 格式 类 型 
Wav_get_channels (wav) ，// 通道 数 
wav_get_rate (wav) * 1000，// 毫 赫兹 / 秒 的 样本 数 
wav_get_bits (wav) ，// 每 个 样本 的 位 数 
wav_get_bits (wav) ，// 容器 大 小 
SL_SPEAKER_FRONT_CENTER，// 通道 屏蔽 
SIL_BYTEORDER_ LITTLEENDIRAN // 字 节 顺序 
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] 


// 数 据 源 是 含有 PCM 格式 的 简单 缓冲 区 队列 

SLDataSource dataSource = { 
&dataSourceLocator，// 数据 定位 器 
&dataSourceFormat // 数据 格式 

] 


// 针 对 数据 接收 器 的 输出 混合 定位 器 

SLDataLocator OutputMix dqataSinkLocator = { 
SL_DATALOCATOR_OUTPUTMIX，// 定位 器 类 型 
outputMixobject // 输 出 混合 

}; 


/ /数据 定位 器 是 一 个 输出 混合 

SLDataSink dataSink = { 
&dataSinkLocator，// 定位 器 
0 // 格式 

] 


// 需 要 的 接口 

SLInterfaceID interfaceIds[] = { 
SL _IID BUFFERQUEUE 

}; 


// 需 要 的 接口 。 如 果 所 需要 的 接口 不 要 用 ， 请 求 将 失败 。 
SLboolean requiredInterfaces[] = { 

SL BOOLEAN TRUE // for SL IID BUFFERQUEUE 
}; 


// 创 建 音频 播放 器 对 象 
SLresult result = (*engineEngine)->CreateAudioPlayer!( 
engineEngine, 
&audioPlayerObject, 
&dataSource, 
&datasink, 
ARRAY_ LEN (interfaceIds), 
interfaceIds, 
requiredInterfaces); 


} 

(16) 通过 Buffer Queue Interface 对 缓冲 区 进行 管理 。 通 过 该 接口 ， 对 缓冲 区 进行 排序 
播放 , 而 且 通 过 注册 一 个 回调 函数 , 在 队列 中 的 缓冲 区 被 音频 播放 器 播放 完 时 可 收 到 通知 。 
附 上 该 函数 的 源 文件 ， 如 程序 清单 13-19 所 示 。 

程序 清单 13-19 GetAudioPlayerBufferQueuelnterface 函数 


/** 
* 获 得 音频 播放 器 缓冲 区 队列 接口 
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* @param env JNIEnv interface. 
* @param audioPlayerobject audio player object instance. 
* @param audioPlayerBufferQueue audio player buffer queue. [OUT] 
* @throws IOException 
sp 
static void GetAudioPlayerBufferQueueInterface( 
JNIEnv* enVv 
SLObjectItf audioPlayerObject, 
SLAndroidsimpleBufferQueueItf& audioPlayerBufferQueue) 


// 获 得 缓冲 区 队列 接口 

SLresult result = (*audioPlayerObject) ->GetInterface( 
audioPlayerOobject， 
SL _IID BUFFERQUEUE， 
&audioPlayerBufferQueue); 


// 错误 检查 
CheckError (env, result); 


} 


(17) DestroyContext 函数 用 于 在 播放 器 停止 时 释放 OpenSL ES 资源 和 缓冲 
函数 ， 如 程序 清单 13-20 所 示 。 


。 附 上 该 


程序 清单 13-20 ”释放 播放 器 上 下 文 的 DestroyContext 函数 


/**# 
* 销 毁 播放 器 上 下 文 


* @param ctx player context. 
i 
static void DestroyContext (PlayerContext*& ctx) 
{ 
// 销 毁 音频 播放 器 对 象 
DestroyObject (ctx->audioPlayerObject); 


// 释 放 播放 器 缓冲 区 
FreePlayerBuffer (ctx->buffer); 


// 销 毁 输 出 混合 对 象 
DestroyObject (ctx->outputMixObject); 


// 销 毁 引 擎 实例 
DestroyObject (ctx->engineObject); 


// 关 闭 WAVE 文件 


CloseWaveFile (ctx->wav); 
// 释 放 上 下 文 


delete ctx; 
ctx = 07 
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(18) 当 播 放 器 完成 对 前 一 个 缓冲 区 队列 的 播放 时 ，OpenSL ES 音频 播放 器 对 象 会 调用 
PlayerCallback 函数 。 在 该 回调 中 , 应 用 程序 简单 地 读 取 和 排列 下 一 个 用 于 播放 的 音频 数据 
块 。 如 果 WAVE 音频 文件 播放 结束 ，DestroyContext 函数 会 被 调用 以 释放 资源 。 附 上 该 函 
数 的 源 代码 ， 如 程序 清单 13-21 所 示 。 


程序 清单 13-21 PlayerCallback 函数 
/妇女 


* 当 一 个 缓冲 区 完成 播放 时 获得 调用 


* @param audioPlayerBufferQueue audio player buffer queue. 
* Q@param context player context. 
Np 
static void PlayerCallback( 
SLAndroidSimpleBufferQueueItf audioPlayerBufferQueuey， 
void* context) 


// 获 得 播放 器 上 下 文 
PlayerContext* ctx = (PlayerContext*) Context7 
// 读 取 数 据 
ssize t readSize = waV_read datal 
ctx->wav, 


ctx->buffer, 
ctx->bufferSsize); 


// 如 果 数 据 被 读 取 
if (0 < readSize) 
{ 

(*audioPlayerBufferQueue) ->Enqueue( 
audioPlayerBufferQueue, 
ctx->buffer, 
readSize); 

} 
else 
{ 
DestroyContext (ctx); 
} 
} 


(19) PlayerCallback 通过 Buffer Queue Interface 提供 的 RegisterCallback 函数 进行 注册 。 
在 注册 过 程 中 ， 会 提供 一 个 上 下 文 指针 ， 以 便当 音频 播放 器 调用 它 时 该 回调 函数 可 以 收 到 
这 个 上 下 文 指针 。 附 上 该 函数 的 源 代码 ， 如 程序 清单 13-22 所 示 。 

程序 清单 13-22 RegisterPlayerCallback 函数 


/妇女 


* 注 册 播 放 器 回调 
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@param env JNIEnv interface. 

param audioPlayerBufferQueue audio player buffer queue. 
@param ctx player context. 

Qthrows IOException 

Sp 

static void RegisterPlayerCallback( 

JNIEnv* enVv 

SLRAndroidSimpleBufferQueueItf audioPlayerBufferQueuey， 
PlayerContext* ctx) 


// 注 册 播 放 器 回调 

SLresult result = (*audioPlayerBufferQueue)->RegisterCallback( 
audioPlayerBufferQueue， 
PlayerCallback, 
ctx); // player context 


// 错 误 检查 


CheckError (env, result); 


} 


(20) Play Interface 用 来 与 音频 播放 器 交互 。GetAudioPlayerPlayInterface 辅助 函数 从 给 
定 的 Audio Player Object 中 获得 Play Interface， 如 程序 清单 13-23 所 示 。 


程序 清单 13-23 ”GetAudioPlayerPlaylnterface 函数 


/* 大 
+ 获得 音频 播放 器 播放 接口 


* @param env JNIEnv interface. 
* @param audiopPlayerObject audio player object instance. 
* @param audiopPlayerPlay play interface. [OUT] 
* @throws IOException 
a 
static void GetAudioPlayerPlayInterfacel( 
JNIEnVv* env, 
SLObjectItf audioPlayerObject, 
SLPlayItfg& audioPlayerPlay) 


// 获 得 播放 器 接口 
SLresult result = (*audioPlayerObject)->GetInterfacel( 
audioPlayerObject, 


SL _IID PLAY, 
&audioPlayerPlay); 


// 错 误 检 查 


CheckError (env, result); 


} 


(21) 音频 播放 器 可 以 通过 用 Play Interface 提供 的 SetPlayState 函数 来 启动 。 一 旦 播放 
器 被 设置 为 播放 状态 , 该 音频 播放 器 开始 等 待 缓冲 区 排队 就 绕 。SetAudioPlayerStatePlaying 
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函数 将 音频 播放 器 设置 为 播放 状态 ， 如 程序 清单 13-24 所 示 。 


程序 清单 13-24 ”SetAudioPlayerStatePlaying 函数 


/二 太 


* 把 音频 播放 器 设置 为 播放 状态 


* Q@param env JNIEnv interface. 
* @param audioPlayerPlay play interface. 
* @throws IOException 
Wy 
static void SetaudioPlayerStatePlaying( 
JNIEnv* env, 
SLPlayItf audioPlayerPlay) 


// 把 音频 播放 器 状态 设置 为 播放 

SLresult result = (*audioPlayerPlay)->SetPlayState( 
audiopPlayerPlay, 
SL_PLAYSTATE PLAYING); 


// 错误 检查 
CheckError (env, result); 


} 


(22) 现在 所 有 函数 已 经 准备 好 了 ,原生 播放 函数 用 前 面 已 经 实现 的 辅助 函数 来 实现 播 
放 器 流程 ， 如 程序 清单 13-25 所 示 。 


程序 清单 13-25 ”Play Native Method 实现 播放 器 逻辑 


void Java_ com apress wavplayer MainActivity play( 
JNIEnVv* env, 
jobject obj, 
jstring fileName) 


PlayerContext* ctx = new PlayerContext(); 


// 打 开 WAVE 文件 
ctx->wav = OpenWaveFile(env, fileName); 
if (0 != env->ExceptionOccurred()) 

goto exit; 


// 创 建 openSL ES 引擎 

CreateEngine (env, ctx->engineObject); 

if (0 != env->ExceptionOccurred()) 
goto exit; 


// 实 现 引擎 对 象 

RealizeObject (env, ctx->engineObject); 

if (0 != env->ExceptionOccurred()) 
goto exit; 
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// 获 得 引擎 接口 
GetEngineInterface( 
env, 
ctx->engineObject, 
ctx->engineEngine); 
if (0 != env->ExceptionOccurred()) 
goto exit; 


// 创 建 输出 混合 对 象 
CreateOutputMix( 
env, 
ctx->engineEngine, 
ctx->outputMixObject); 
if (0 != env->ExceptionOccurred()) 
goto exit; 


// 实 现 输出 混合 对 象 
RealizeObject (env, ctx->outputMixObject); 
if (0 != env->ExceptionOccurred()) 

goto exit; 


// 初始 化 缓冲 区 
InitPlayerBuffer( 
env, 
ctx->wav, 
ctx->buffer, 
ctx->bufferSize); 
if (0 != env->ExceptionOccurred()) 
goto exit; 


// 创 建 缓冲 区 队列 音频 播放 器 对 象 
CreateBufferQueueAudioPlayer( 
Ctx->wav, 
ctx->engineEngine, 
ctx->outputMixObject, 
ctx->audioPlayerObject); 
if (0 != env->ExceptionOccurred()) 
goto exit; 


// 实 现 音频 播放 器 对 象 
RealizeObject (env, ctx->audiopPlayerObject); 
if (0 != env->ExceptionOccurred()) 

goto exit; 


// 获 得 音频 播放 器 缓冲 区 队列 接口 
GetaAudioPlayerBufferQueueInterface( 
env, 
ctx->audioPlayerObject, 
ctx->audioPlayerBufferQueue); 
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if (0 != env->ExceptionOccurred()) 
goto exit; 


// 注 册 播 放 器 回调 函数 

RegisterPlayerCallback( 
env, 
ctx->audioPlayerBufferQueue, 
ctx); 

if (0 != env->ExceptionOccurred()) 


goto exit; 


// 获 得 音频 播放 器 播放 接口 
GetRAudioPlayerPlayInterface( 
env, 
ctx->audioPlayerObject, 
ctx->audiopPlayerPlay); 
if (0 != env->ExceptionOccurred()) 
goto exit; 


// 设 置 音频 播放 器 为 播放 状态 
SetAudioPlayerstatePlaying (env, ctx->audioPlayerPlay); 
if (0 != env->ExceptionOccurred()) 

goto exit; 


// 将 第 一 个 缓冲 区 入 队 来 启动 运行 
PlayerCallback (ctx->audioPlayerBufferQueue， ctx) 
exXit: 
// 如 果 发 生 异 常 就 销毁 
if (0 != env->ExceptionOccurred()) 
DestroyContext (ctx); 
} 


将 应 用 程序 和 原生 模块 实现 一 起 重新 构建 之 后 ， 就 可 以 准备 体验 示例 应 用 程序 了 。 
13.3 运行 WAVE Audio Player 


为 了 体验 基于 OpenSL ES 的 WAVE 播放 器 ， 按 照 以 下 步骤 来 运行 该 应 用 程序 。 

(1) 在 运行 该 应 用 程序 之 前 ， 需 要 有 一 个 WAVE 音频 文件 样本 。 用 你 的 浏览 器 从 
www.nch.com.au/acmy/8kl16bitpcm.wav 处 下 载 8 000Hz 16 位 PCM WAVE 音频 文件 样本 。 

(2) 用 ADB 调用 下 面 的 命令 : 将 WAVE 音频 文件 放 在 目标 设备 的 SD 卡 或 模拟 器 中 。 


adb push 8kl6bitpcm.wav /sdcard/ 


G) 现在 启动 该 应 用 程序 。 
(4) 该 应 用 程序 启动 之 后 ， 一 个 简单 GUI 将 会 显示 出 来 ， 如 图 13-1 所 示 。 
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“4 BB 5:31 
© MainActivity 
_8kl 6bitpcm.way 


Play 


图 13-1 WAVE 播放 器 简单 的 用 户 界面 
(5) 单 击 Play 按钮 启动 该 播放 器 ，WAVE 音频 文件 将 开始 播放 。 


13.4 ”小结 


本 章 学 习 了 Android 平台 为 原生 代码 提供 的 OpenSL ES 原生 音频 API。 通 过 使 用 这 个 
API， 原 生 代码 能 够 播放 和 录制 音频 而 无 须 与 Java 层 进行 通信 。 该 功能 极 大 地 提高 了 多 媒 
体 应 用 程序 的 性 能 。 
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程序 概要 分 析 和 NEON 优化 


在 前 面 几 章 中 , 我 们 学 习 了 如 何在 Android 平台 上 开发 原生 应 用 程序 , 介绍 了 Android 
平台 和 Linux 操作 系统 提供 的 原生 API。 最 后 一 章 将 涵盖 以 下 主要 内 容 : 
e 使 用 GNU Profiler 剖析 原生 Android 应 用 程序 以 确定 性 能 瓶颈 。 
e 通过 内 部 编译 器 使 用 ARM NEON 技术 优化 原生 应 用 程序 。 
。 在 编译 器 内 启用 自动 向 量化 支持 ， 在 不 改变 源 代码 的 情况 下 无 颖 地 提高 原生 应 用 
程序 的 性 能 。 


14.1 用 GNU Profiler 度量 性 能 


GNU Profiler 也 被 称 为 gprof 应 用 程序 ， 是 基于 UNIX 的 程序 概要 分 析 工 具 。gprof 可 
以 通过 使 用 仪器 和 抽样 收集 和 报告 每 个 函数 消耗 的 绝对 执行 时 间 。 如 果 编 译 时 提供 了 -pg 
操作 ， 仪 器 可 以 通过 GNU C/C++ 编译 器 来 执行 。 程 序 执行 后 ， 抽 样 数据 会 自动 地 保存 在 
gmon.out 数据 文件 里 ， 之 后 gprof 工具 会 通过 处 理 该 数据 文件 来 生成 程序 概要 分 析 报 告 。 
Android NDK 也 配 有 gprof 工具 。 然 而 GNU C/+ 编 译 器 工具 链 配备 的 Android NDK 缺少 
__ gnu_mcount_nc 函数 的 实现 , 该 函数 是 测试 函数 运行 消耗 时 间 所 必需 的 。 为 了 在 Android 
NDK 原生 项 目 中 使 用 gprof 工具 ,我们 将 使 用 一 个 名 为 Android NDK Profiler 的 开源 项 目 。 
更 多 关于 Android NDK Profiler 开源 项 目的 信息 , 可 以 在 其 官方 网 站 http://code.google.com/ 
p/android-ndk-profiler/ 中 找到 。 


14.1.1 安装 Android NDK Profiler 


按照 以 下 步骤 安装 Android NDK Profiler 原生 模块 : 

(1) 通过 浏览 器 进入 https://github.com/cinar/android-ndk-profiler/zipball/master 下 载 Android 
NDK Profiler 原生 模块 ZIP 格式 的 文件 。 

(2) 直接 把 ZIP 归档 文件 中 的 内 容 提取 到 NDK 原生 模块 子 目 录 ANDROID NDK_ HOME/ 
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source 中 。 将 提取 出 的 目录 cinar-android-ndk-profiler-9cdf13 重 命 名 为 android-ndk-profiler。 
现在 ， 作 为 一 个 原生 模块 ，Android NDK Profiler 已 经 就 绪 ， 任 何 Android NDK 原生 
项 目 都 可 以 使 用 它 。 现 在 马上 就 要 学 习 启 用 Android NDK Profiler 以 便 原生 项 目 可 以 使 
用 它 。 
14.1.2 启用 Android NDK Profiler 
需要 在 编译 期 间 启用 Android NDK Profiler 以 便 收集 程序 概要 分 析 的 数据 。 为 了 在 原 
生 Android 项 目 中 启用 Android NDK Profiler， 请 按照 下 列 步骤 配置 。 


(1) 需要 修改 Android.mk 生成 脚本 ， 以 实现 同 之 前 安装 的 andprof 库 进 行 静态 链接 。 
可 以 按照 程序 清单 14-1 所 示 修 改 Android.mk 文件 。 


程序 清单 14-1 在 Android.mk 生成 脚本 中 启用 Android NDK Profiler 
LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := module 


# 启 用 Android NDK Profiler 
MY_ANDROID NDK PROFILER ENABLED := true 


# 如 果 Android NDK Profiler 已 经 被 启用 
ifeq ($(MY ANDROID NDK PROFILER ENABLED) ,true) 


# 显 示 信 息 
$(info GNU Profiler is enabled) 


# 启 用 监控 功能 
LOCAL CFLAGS += —DMY ANDROID NDK PROFILER ENABLED 


# 使 用 Enable the monitor functions 静态 库 
LOCAL STATIC LIBRARIES += andprof 
Endif 


include $ (BUILD SHARED LIBRARY) 


# 如 果 Androiqd NDK Profiler 已 经 被 启用 
ifeq ($(MY ANDROID NDK PROFILER ENABLED) ,true) 
# 导入 Android NDK Profiler 库 模 块 
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$ (call import-module, android-ndk-profiler/jni) 

endif 

(2) 根据 这 些 修改 , 可 以 通过 将 构建 系统 变量 MY_ANDROID NDK_PROFILER ENABLED 
设置 为 true 或 false 来 启用 和 禁用 程序 概要 分 析 。 

(3) 因为 原生 代码 运行 在 共享 库 内 ， 所 以 程序 概要 分 析 生 命 周 期 需要 手动 地 进行 管理 。 
Android NDK Profiler 提供 函数 来 启动 和 停止 收集 程序 概要 分 析 数 据 。 这 些 函数 已 经 在 
profh 头 文件 中 进行 了 声明 ， 所 以 在 使 用 这 些 函数 之 前 ， 首 先 要 将 prof.h 头 文件 包含 进来 ， 
如 程序 清单 14-2 所 示 : 


程序 清单 14-2 将 Android NDK Profiler 头 文件 包含 进来 


#ifdef MY ANDROID NDK PROFILER ENABLED 
#include <prof.h> 
#endif 


(4) 为 了 开始 收集 程序 概要 分 析 数 据 , 需要 调用 monstartup 函数 。monstartup 函数 获取 
共享 库 的 名 字 作为 其 参数 并 开始 收集 程序 概要 分 析 数 据 。 根 据 应 用 程序 的 生命 周期 ， 在 你 
想 要 的 点 调用 monstartup 函数 和 收集 程序 概要 分 析 数据 。 如 程序 清单 14-3 所 示 : 


程序 清单 14-3 ”通过 调用 monstartup 函数 来 启动 数据 收集 


#ifdef MY ANDROID NDK PROFILER ENABLED 
// 启 动 收 集 示例 
monstartup ("libModule.so"); 

#endif 


(5) 通过 调用 moncleanup 函数 来 停止 收集 程序 概要 分 析 数 据 。moncleanup 函数 负责 将 
收集 的 程序 概要 分 析 数 据 保存 到 SD 卡 上 的 gmon.out 文件 里 。 如 程序 清单 14-4 所 示 : 


程序 清单 14-4 ”调用 moncleanup 来 停止 收集 数据 


#ifdef MY ANDROID NDK PROFILER ENABLED 
// 存储 已 收集 的 数据 
moncleanup (); 

#endif 


注意 : 


在 对 应 用 程序 进行 程序 概要 分 析 之 前 ， 请 确保 应 用 程序 有 适当 的 权限 可 以 对 SD 卡 进 
行 写 操作 。 


14.1.3 使 用 GNU Profiler 分 析 gmon.out 文件 


可 以 使 用 GNU Profiler gprof 工具 对 Android NDK Profiler 生成 的 程序 概要 分 析 数 据 文 
件 gmon.out 进行 处 理 。 该 工具 会 根据 提供 的 程序 概要 分 析 数 据 文件 生成 可 读 的 报告 。 请 按 
照 下 面 这 些 步 骤 来 处 理 gmon.out 文件 。 

(1) 使 用 adb 命令 将 程序 概要 分 析 数 据 文件 gmon.out 从 SD 卡 上 下 载 到 计算 机 上 。 
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adb pull /sdcard/gmon.out 


(2) GNU Profiler 需要 调试 标志 和 程序 概要 分 析 数 据 文件 来 生成 报告 。 启 动 arm-linux- 
androideabi-gprof.exe 应 用 程序 , 该 应 用 程序 带 有 共享 库 的 调试 版 本 和 gmon.out 程序 概要 分 
析 数 据 文件 。 


SANDROID NDK HOME%\toolchains\arm-linux-androideabi-4.4.3\prebuilt\ 
windows\bin\armlinux— 
androideabi-gprof.exe obj\local\armeabi-v7ia\libModule.so gmon.out 


(3) 用 arm-linuxandroideabi-gprof 基于 主机 平台 中 的 正确 位 置 来 替换 应 用 程序 的 路 径 。 
用 正在 对 其 进行 程序 概要 分 析 文 件 的 正确 体系 结构 来 替换 armeabi-v7a 目录 。 

(4) GNU Profiler 将 会 解析 程序 概要 分 析 数 据 文件 和 生成 报告 ， 如 程序 清单 14-5 所 示 。 
生成 的 报告 有 两 部 分 组 成 ，flat profile 和 call graph。 两 个 部 分 都 用 表格 来 呈现 程序 概要 分 
析 数 据 ， 报 告 里 还 提供 了 对 每 个 测试 的 描述 。 


程序 清单 14-5 ”GNU Profiler 报告 文件 


Flat profile: 


Each sample counts as 0.01 seconds. 
% cumulative self self total 
time seconds seconds calls ms/call ms/call name 
99.53 2.12 2.12 361 5.87 与 -87 func2 
0.47 2.13 0.01 funcl 


Call graph (explanation follows) 
granularity: each sample hit covers 2 byte(s) for 0.47% of 2.13 seconds 


index $% time self children called name 
<spontaneous> 
L111 3939.5 .0.00 2.12 funcl [1] 
2.12 0.00 361/361 func2 [2] 


当 实 现 了 新 的 功能 或 者 对 应 用 程序 进行 了 优化 时 ， 就 可 以 重复 这 些 步骤 来 监控 应 用 程 
序 的 性 能 。 在 第 14.2 节 中 ， 当 通过 ARM NEON intrinsics 优化 原生 函数 时 将 会 用 到 GNU 
Profiler。 


14.2 ”使 用 ARM NEON Intrinsics 进行 优化 


在 本 节 中 ， 我 们 将 会 重新 使 用 在 12 章 实现 的 基于 Bitmap renderer 的 AVI 播放 器 示例 
应 用 程序 。 并 通过 使 用 纯 C 代码 实现 亮度 过 滤器 来 扩展 该 示例 应 用 程序 。 在 本 节 的 后 面部 
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分 ， 将 会 重新 实现 亮度 过 滤器 函数 ， 并 使 用 ARM NEON intrinsics 优化 其 性 能 。 并 会 像 前 
面 章节 中 描述 的 那样 ， 我 们 将 使 用 GNU Profiler 比较 两 个 实现 的 性 能 。 


14.2.1 ARM NEON 技术 概述 


在 ARM 处 理 器 中 实现 的 单 指令 、 多 数据 (single instruction，mnultiple data，SLMD) 被 称 
为 NEON。SIMD 通过 多 个 数据 点 上 执行 相同 的 操作 实现 数据 级 并 行 。SIMD 技术 可 以 通 
过 启用 单 指令 向 量 运 算 ， 来 对 原生 应 用 程序 性 能 进行 加 速 。 多 媒体 应 用 程序 从 SIMD 技术 
受益 最 多 , 因为 它们 可 以 对 多 种 格式 的 数据 集 执行 相同 的 操作 ， 比 如 视频 帧 或 音频 数据 块 。 
NEON 技术 适用 于 大 部 分 的 ARM Cortex-A 系列 处 理 器 。 

在 NEON 技术 中 ,数据 被 组 织 成 64 位 D 寄存 器 或 128 位 的 Q 寄存 器 。 这些 寄 存 器 可 
以 容纳 8 位 、16 位 、32 位 和 64 位 宽 的 数据 向 量 ， 如 图 14-1 所 示 。 


64 位 D 寄存 器 64 位 D 寄存 器 


4X32 位 
128 位 sx16 位 
Q 寄存 器 16X8 位 


图 14-1 NEON 寄存 器 和 数据 类 型 


NEON 技术 同样 提供 了 一 套 指 令 集 来 操作 这 些 数据 向 量 。 更 多 关于 NEON 技术 以 及 
其 支持 的 指令 等 信息 可 以 在 http://infocenter.arm.com/help/index.jsp?topic=/com.arm.doc. 
dht0002a/ch01s04s03.html 中 ARM 的 “Introducing NEON Development Article” 中 找到 。 


14.2.2 给 AVI Player 添加 一 个 亮度 过 滤器 


按照 以 下 步骤 添加 亮度 播放 器 。 

(1) 使 用 Project Explorer， 在 jni 子 目录 下 创建 一 个 新 的 C/C++ 头 文件 。 

(2) 将 C/C++ 头 文件 命名 为 BrightnessFilter.h 并 用 程序 清单 14-6 中 的 代码 修改 文件 中 
的 内 容 。 


程序 清单 14-6 ”BrightnessFilter.h 头 文件 内 容 
#pragma once 


/**# 
* 提取 交错 部 分 ，RGB565 色彩 空间 总 共有 16 位 
* 其 中 红色 5 位 ， 绿 色 6 位 和 蓝 色 5 位 
i 
void brightnessFilter( 
unsigned short* pixels, 
long count, 
unsigned char brightness); 
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G3) 创建 新 的 C/C++ 资源 文件 ， 并 命名 为 BrightnessFilter.cpp， 然 后 修改 其 内 容 ， 如 程 
序 清单 14-7 所 示 。brightnessFilter 函数 只 是 简单 地 调用 genericBrightnessFilter 函数 ， 该 函 
数 是 使 用 纯 C 实现 了 亮度 过 滤器 的 功能 。 它 采用 一 个 16 位 像素 的 数组 来 格式 化 使 用 
RGB565 色彩 空间 。 它 将 颜色 组 成 部 分 分 解 成 为 三 个 8 位 的 值 ， 并 根据 所 给 的 亮度 值 给 他 
们 增 量 。 同 样 ， 该 函数 会 根据 每 个 值 的 范围 对 其 进行 校正 ， 并 将 它们 结合 到 一 起 放 入 一 个 
RGB565 色彩 空间 内 的 16 位 像素 中 。 


程序 清单 14-7 ” 源 文件 BrightnessFilter.cpp 的 内 容 


#include "BrightnessFilter.h" 


static void genericBrightnessFilter!( 
unsigned short* pixels, 
long count, 
unsigned char brightness) 


const unsigned char MAX RB = OxF8; 
const unsigned char MAX G = OxFC; 


unsigned short r, g, b; 


for (long i = 0; i < count; i++) 
// 分 解 颜色 
天 (pixels[i] >> 8) & MAX RB; 
g= (pixels[i] >> 3) & MAX G; 
b = (pixels[i] << 3) & MAX RB; 


// 亮 度 增 量 

r += brightness; 
g += brightness; 
b += brightness; 


// 确 保 颜色 组 成 部 分 的 值 在 范围 内 

r= (rr > MAX RB) ? MAX RB : r; 
g= (g> MAX G) ?MAXG:g; 
b= (b> MAX RB) ? MAX RB : b; 


// 设 置 像素 

pixels[i] = (r << 8); 

pixels[i] |= (g << 3); 
pixels[i] |= (b >> 3); 


} 


void brightnessFilter( 
unsigned short* pixels, 
long count, 
unsigned char brightness) 
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{ 
genericBrightnessFilter (pixels, count, brightness); 


} 
(4) 每 个 AVI 视频 帧 泻 染 之 前 都 需要 调用 Brightness Filter。 为 此 ， 打 开 com apress_ 


aviplayer BitmapPlayerActivity.cpp 源 文件 。 
(5) 将 BrightnessFilterh 头 文件 添加 到 包含 列表 中 ， 如 程序 清单 14-8 所 示 。 


程序 清单 14-8 将 BrightnessFilter.h 头 文件 添加 到 BitmapRenderer 中 


extern "C" { 
#include <avilib.h> 


} 


#include <android/bitmap.h> 

#include "BrightnessFilter.h" 

#include "Common.h" 

#include "com apress aviplayer BitmapPlayerActivity.h" 


(6) 修改 renderer 函数 如 程序 清单 14-9 所 示 ， 这 样 它 处 理 每 一 帧 画面 时 都 会 调用 
brightnessFilter 函数 。 
程序 清单 14-9 ”对 每 一 帧 调用 brightnessFilter 函数 


jboolean Java com apress aviplayer BitmapPlayerActivity render( 
JNIEnv* env, 
jclass clazz, 
jlong avi, 
jobject bitmap) 


// 将 AVI 帧 字 节 读 入 到 bitmap 


frameSize = AVI read frame((avi t*) avi, frameBuffer, &keyFrame); 
// 应 用 亮度 过 滤器 


brightnessFilter((unsigned short*) frameBuffer, frameSize/2, 1); 


} 


(7) 将 BrightnessFilter.cpp 源 文件 加 入 到 Android.mk 构建 脚本 中 , 如 程序 清单 14-10 
所 示 。 


程序 清单 14-10 ”将 BrightnessFilter.cpp 源 文 件 添加 到 Android.mk 中 


LOCAL PATH := $(call my-dir) 
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include $ (CLEAR VARS) 


LOCAL MODULE := AVIPlayer 

LOCAL SRC FILES := \ 
Common.cpp \ 
com apress aviplayer AbstractPlayerActivity.cpp \ 
com apress aviplayer BitmapPlayerActivity.cpp 


LOCAL SRC FILES += BrightnessFilter.cpp 


# 使 用 AVILib 静态 库 

LOCAL STATIC LIBRARIES += avilib static 

(8) 现在 Brightness Filter 已 经 整合 到 AVI Player 应 用 程序 中 。 在 启动 应 用 程序 之 前 ， 
先 要 启用 GNU Profiler。 


14.2.3 为 AVI 播放 器 启用 Android NDK Profiler 


如 前 所 述 ， 为 了 收集 程序 概要 分 析 数 据 ， 需 要 在 编译 时 启用 GNU Profiler。 

按照 以 下 步骤 为 Bitmap renderer AVI Player 启用 GNU Profiler。 

(1) 修改 Android.mk 构建 脚本 来 启用 GNU Profiler。 

(2) 使 用 Project Explorer 展开 jni 子 目录 ,并 打开 源 文件 com_apress_aviplayer_Abstract- 
PlayerActivity.cpp 。 

(3) 修改 代码 来 调用 Android NDK Profiler 函数 , 如 程序 清单 14-11 所 示 。 当 AVI 打开 
和 关闭 时 ， 程 序 概要 分 析 就 会 相应 地 开始 和 结束 。 这 提供 了 AVI 处 理 期 间 的 程序 概要 分 析 
数据 。 

程序 清单 14-11 从 AbstractPlayerActivity 中 调用 Profiler 函数 

extern "C" { 


#include <avilib.h> 


} 


#ifdef MY ANDROID NDK PROFILER ENABLED 
#include <prof.h> 
#endif 


jlong Java_ com apress aviplayer AbstractPlayerActivity open( 
JNIEnv* env, 
jclass clazz, 
jstring fileName) 


avi t* avi = 0; 


#ifdef MY ANDROID NDK PROFILER ENABLED 


// 开 始 收集 样本 
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monstartup ("libAVIPlayer.so"); 
#endif 


void Java com apress aviplayer AbstractPlayerActivity close( 
JNIEnv* env, 
jclass clazz, 
jlong avi) 


AVI close((avi t*) avi); 


#ifdef MY ANDROID NDK PROFILER ENABLED 
// 存储 所 收集 的 数据 


moncleanup () 
#endif 
} 


(4) 因为 Android NDK Profiler 将 程序 概要 分 析 数 据 文件 存储 到 SD 卡 上 ， 需 要 给 清单 
文件 赋予 恰当 的 授权 。 用 Project Explorer 打开 AndroidManifest xml 文件 , 如 程序 清单 14-12 
所 示 对 其 进行 修改 。 


程序 清单 14-12 ”添加 外 部 存储 器 的 写 入 权限 


<manifest xmlns:android="http://schemas.android.com/apk/res/android" 
package="com.apress.aviplayer" 
android:versionCode="1" 
android:versionName="]1.0" > 


<uses-permission 
android:name="android.permission.WRITE EXTERNAL STORAGE" > 


</manifest> 
现在 对 于 AVIPlayer 项 目 来 说 GNU Profiler 是 可 用 的 了 。 可 以 启动 应 用 程序 来 收集 程 
序 概要 分 析 数 据 了 。 


14.2.4 ”AVI Player 程序 概要 分 析 


按照 以 下 步骤 来 对 Bitmap renderer AVI Player 应 用 程序 进行 概要 分 析 。 
(1) 启动 一 个 实际 Android 设备 上 的 应 用 程序 。 
(2) 用 Bitmap renderer 开始 播放 AVI 文件 。 
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(3) 一 直 等 到 AVI 播放 结束 。 

(4) 单 击 设备 上 的 硬 返 回 键 。 

(5) 正如 本 章 前 面 所 说 明 的 , 从 设备 上 将 gmon.out 程序 概要 分 析 数 据 下 载 到 计算 机 中 。 
(6) 如 程序 清单 14-13 所 示 ， 使 用 gprof 工具 生成 报告 。 


程序 清单 14-13 ”通用 亮度 过 滤器 程序 概要 分 析 报告 


Flat profile: 


Each sample counts as 0.01 seconds. 
% cumulative self self total 
time seconds seconds calls ms/call ms/call name 
100.00 2.62 2.62 361 7.26 7.26 brightnessFilter (unsigned short*, 
long, unsigned char) 


根据 这 份 报告 , brightnessFilter 函数 调用 genericBrightnessFilter 函数 处 理 每 帧 画面 花费 
7.26 微 秒 ， 而 处 理 所 有 帧 总 共 花 费 2.62 秒 。 


14.2.5 使 用 NEON Intrinsics 优化 Brightness Filter 


现在 将 要 使 用 ARM NEON intrinsics 优化 genericBrightnessFilter 函数 。 

(1) 使 用 Project Explorer 定位 到 jni 子 目录 。 

(2) 打开 BrightnessFilter.cpp 源 文件 ,并 添加 NEON 优化 过 的 neonBrightnessFilter 函数 ， 
如 程序 清单 14-14 所 示 。 相 对 于 通用 的 亮度 过 滤器 的 实现 , ARM NEON 优化 过 的 亮度 过 滤 
器 一 次 能 够 处 理 8 个 像素 而 不 是 只 处 理 1 个 像素 。 


程序 清单 14-14 ”修改 后 的 BrightnessFilter.cpp 源 文件 内 容 
#include "BrightnessFilter.h" 
#ifdef _ ARM NEON 
#include <cpu-features.h> 
#include <arm neon.h> 
static void neonBrightnessFilter( 
unsigned short* pixels, 
long count, 


unsigned char brightness) 


const unsigned char MAX RB = OxF8; 
const unsigned char MAX G = OxFC; 


uint8x8 _t maxRb = vmov n u8 (MAX RB); 
uint8x8 t maxG = vmov n u8 (MAX G); 
uint8x8 t increment = vmov n u8(brightness); 
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for (long i = 0; i < count; i += 8) 
{ 
// 加 载 8 个 16 位 像素 
uint16x8 t rgb = vldliq ul16 (gpixels[i]); 


// r= (pixels[i] >> 8) & MAX RB; 
uint8x8 t r = vshrn n ul6(rgb, 8); 
r= vand u8(r, maxRb); 


// g = (pixels[i] >> 3) & MAX G; 
uint8x8 t g = vshrn n ul6(rgb, 3); 
g = vand u8(g, maxG); 


// b = (pixels[i] << 3) & MAX RB; 
uint8x8 t b = vmovn ul6(rgb); 
b= vshl n u8(b, 3); 

b = vand u8(b, maxRb); 


// r += brightness; 
r= vadd u8(r, increment); 


// g += brightness; 
g = vadd u8(g, increment); 


// b += brightness; 
b = vadd u8(b, increment); 


// r= (r > MAX RB) ? MAX RB : r; 
r= vmin u8(r, maxRb); 


//g= (g> MAX G) ?MAXG:g; 
g = vmin u8(g, maxG); 


// b= (b> MAX RB) ? MAX RB : bi 
b = vmin u8(b, maxRb); 


// pixels[i] = (上 << 8); 
rgb = vshll n u8(r, 8); 


// pixels[i] |= (g << 3); 
uint16x8 t g16 = vshll n u8(g, 8); 
rgb = vsriq n ul6(rgb, g16, 5); 

// pixels[i] |= (b >> 3); 
uint16x8 t b16 = vshll n u8(b, 8); 
rgb = vsriq n ulé6(rgb, b16, 11); 


// 存储 8 16 位 像素 
vstlq ul6 (gpixels[i], rgb); 
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} 
#endif 


static void genericBrightnessFilter( 
unsigned short* pixels, 
long count, 
unsigned char brightness) 


(3) 当 适 用 时 ,同样 需要 修改 brightnessFilter 函数 以 便 调用 NEON 优化 过 的 函数 .ARM 
NEON 支持 仅 对 armeabi v7a ABI 有效 。 但 是 请 注意 ， 并 不 是 每 个 基于 ARM-v7 的 设备 都 
支持 NEON 指令 。 原 生 应 用 程序 对 基于 ARM-v7 的 设备 都 希望 检测 NEON 支持 。 为 了 解 
决 这 一 问题 ，Android NDK 自 带 了 CPU Features 原生 导入 模块 。 该 模块 可 以 在 运行 时 检测 
CPU 的 型 号 和 CUP 支持 的 功能 。 修 改 brightnessFilter 函数 ， 如 程序 清单 14-15 所 示 。 


注意 : 
不 是 每 一 个 基于 ARM-v7 的 设备 都 支持 ARM NEON 指令 。 所 以 应 该 在 运行 时 调用 任 
何 NEON 优化 过 的 函数 之 前 ， 总 要 先 使 用 CPU Features 导入 模块 来 检测 NEON 支持 。 


程序 清单 14-15 ”修改 brightnessFilter 函数 调用 NEON 优化 过 的 函数 


void brightnessFilter( 
unsigned short* pixels, 
long count, 
unsigned char brightness) 
{ 
#ifdef _ ARM NEON 


// 获 取 CPU 系列 
AndroidCpuFamily cpuFamily = android getCpuFamily(); 


// 获 取 CPU 功能 
uint64 t cpuFeatures = android getCpuFeatures(); 


// 仅 在 支持 NEON 的 ARM CPUs 上 使 用 NEON 优化 函数 
if ((ANDROID CPU FAMILY ARM == cpuFamily) 
&& ((ANDROID CPU ARM FEATURE NEON & cpuFeatures) != 0)) 
* 
// 调 用 NEON 优化 亮度 过 滤器 
neonBrightnessFilter (pixels, count, brightness); 
} 
else 
{ 
#endif 
// 调 用 通用 的 亮度 过 滤器 
genericBrightnessFilter (pixels, count, brightness); 
#ifdef _ ARM NEON 
} 
#endif 
} 
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(4) 打开 Android.mk 构建 脚本 并 对 其 进行 修改 ， 如 程序 清单 14-16 所 示 。 这 样 就 可 以 
在 编译 期 间 编译 出 合适 版 本 的 brightnessFilter 函数 .针对 ARMv7a 目标 平台 ,会 使 用 NEON 
加 强 版 本 的 brightnessFilter。 对 于 所 有 其 他 的 平台 ， 会 使 用 brightnessFilter 的 通用 实现 。 


程序 清单 14-16 ”将 brightnessFilter 的 NEON 版 本 添加 到 Android.mk 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := AVIPlayer 

LOCAL SRC FILES := \ 
Common.cpp \ 
com apress aviplayer AbstractPlayerActivity.cpp \ 
com apress aviplayer BitmapPlayerActivity.cpp 


# 添加 armeabi-v7a 上 的 NEON 优化 版 本 

ifeq ($(TARGET ARCH ABI),armeabi-v7a) 
LOCAL SRC FILES += BrightnessFilter.cpp.neon 
LOCAL STATIC LIBRARIES += cpufeatures 

else 
LOCAL SRC FILES += BrightnessFilter.cpp 

endif 


# 使 用 AVILib 静态 库 
LOCAL STATIC LIBRARIES += avilib static 


# 启用 Android NDK Profiler 
MY_ANDROID NDK_ PROFILER ENABLED := true 


# Android NDK Profiler 是 否 启用 
ifeq ($(MY ANDROID NDK_ PROFILER ENABLED),true) 


# 显 示 信息 
$(info GNU Profiler is enabled) 


# 启 用 监控 功能 
LOCAL CFLAGS += —DMY ANDROID NDK PROFILER ENABLED 


# 使 用 Enable the monitor functions 静态 库 
LOCAL STATIC LIBRARIES += andprof 


endif 


# 链 接 JNI graphics 
LOCAL LDLIBS += 一 1jnigraphics 


include $ (BUILD SHARED LIBRARY) 


# 导 入 AVILib 库 模 块 


$ (call import-module，transcode-1.1.5/avilib) 


341 


Android C++ 高 级 编程 一 一 使 用 NDK 


# 如 果 Androiq NDK Profiler 已 经 被 启用 

ifdef MY ANDROID NDK PROFILER ENABLED 

# 导 入 Rndroid NDK Profiler 库 模块 

$(call import-module, android-ndk-profiler/jni) 
endif 


# 在 armeabi-v7a 上 添加 CPU 功能 

ifeq ($ (TARGET ARCH ABI) ,armeabi-v7a) 

# 引入 Android CPU 功能 

$ (call import-module, android/cpufeatures) 

endif 

注意 : 

你 可 能 已 经 注意 到 BrightnessFilter.cpp 源 文件 已 经 追加 了 .neon 后 级 。 这 个 后 级 告诉 
Android NDK 构建 系统 该 源 文件 需要 同 ARM NEON 支持 一 起 编译 。 


(5) 创建 一 个 名 为 Application.mk 并 包含 下 面 内 容 的 新 文件 : 


APP ABI := armeabi-V7a 


(6) 当 要 对 NEON-enhanced brightnessFilter 做 程序 概要 分 析 时 ， 更 好 的 做 法 是 将 
armeabi-v7a ABI 作为 单一 的 目标 平台 。 

(7) 重复 相同 的 程序 概要 分 析 步 又 ,由 GNU Profiler 生成 的 报告 会 和 程序 清单 14-17 
很 相似 。 


程序 清单 14-17 ”NEON 优化 的 Brightness Filter 程序 概要 分 析 报告 


Flat profile: 


Each sample counts as 0.01 seconds. 
% cumulative self self total 
time seconds seconds calls ms/call ms/call name 
100.00 0.50 0.50 361 1.39 1.39 brightnessFilter (unsigned short*, 
long, unsigned char) 


根据 这 份 报告 ， 调 用 neonBrightnessFilter 函数 的 brightnessFilter 函数 处 理 每 帧 画面 花 
费 1.39 微 秒 ， 而 处 理 所 有 帧 总 共 花费 0.50 秒 。 相 比 于 通用 的 实现 ，NEON-optimized 函数 
要 快 5 倍 。 


14.3 ”自动 向 量化 


正如 在 第 14.2 节 中 看 到 的 ， 采 用 ARM NEON 支持 对 应 用 程序 的 性 能 有 很 大 的 影响 。 
但 是 , 无 论 是 用 ARM 汇编 语言 或 NEON intrinsic 结构 进行 优化 都 需要 保证 流畅 性 , NEON 
是 一 个 SIMD 在 ARM 上 的 特定 实现 版 本 .为 了 支持 不 同 于 ARM 平台 ,比如 Intel 或 MIPS， 
同样 也 需要 为 其 他 的 SIMD 版 本 ， 比 如 Intel SSE 或 MIPS MDMX 提供 最 优化 的 函数 实现 。 
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汇编 语言 或 intrinsics 不 是 从 SIMD 支持 中 获 益 的 唯一 途径 。 得 益 于 SIMD 引擎 ,在 大 多 
数 情 况 下 GNU C/ C+ + 编译 器 也 可 以 自动 优化 应 用 程序 ， 而 无 须 写 一 行 汇编 代码 或 使 用 
intrinsics。 这 个 过 程 被 称 为 自动 向 量化 。 


14.3.1 启用 自动 向 量化 


为 了 启用 自动 向 量化 ， 请 遵照 下 面 这 些 步 又 : 
(1) 打开 Application.mk 构建 脚本 ， 并 确保 APP_ABI 包含 armeabi-v7a。 


APP ABI := armeabi armeabi-v7a 


(2) 打开 Application.mk 构建 脚本 ， 并 给 构建 系统 变量 LOCAL_CFLAGS 加 上 参数 
-ftree-vectorize， 如 程序 清单 14-18 所 示 。 


程序 清单 14-18 ”启用 GNU C/C++ 编译 器 自动 向 量化 


LOCAL PATH := $(call my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE := module 


LOCAL CFLAGS += -ftree-vectorize 


include $ (BUILD SHARED LIBRARY) 


(3) 确保 源 文件 和 ARM NEON 支持 一 起 得 到 编译 ， 如 程序 清单 14-19 所 示 。 


程序 清单 14-19 ”对 所 有 的 源 文件 启用 ARM NEON 


LOCAL PATH := $(call my-dir) 


include $ (CLEAR VARS) 


# 将 ARM NEON 支持 添加 到 所 有 源 文件 中 
ifeq ($(TARGET ARCH RARBI) ,armeabi-v7a) 
LOCAL ARM NEON := true 


include $ (BUILD SHARED LIBRARY) 
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根据 这 些 修改 ，GNU C/C++ 编译 器 会 试图 自动 向 量化 原生 应 用 程序 ， 进 而 从 ARM 
NEON 支持 中 受益 。 

C/C++ 语言 没有 提供 任何 机 制 来 指定 并 行 行为 。 关 于 哪些 代码 可 以 安全 的 进行 自动 向 
量化 ， 可 有 需要 给 GNU C/C++ 编译 器 额外 的 提示 。 至 于 自动 向 量化 循环 的 一 览 表 ， 请 在 
http://gcc.gnu.org/projects/tree-ssa/vectorization .html 地 址 下 参见 “Auto-vectorization in GCC” 
文件 。 


14.3.2 自动 向 量化 问题 的 发 现 和 排除 
当 要 发 现 并 排除 自动 向 量化 中 的 问题 时 ， 可 以 通过 给 构建 系统 变量 LOCAL_ CFLAGS 
加 上 自 变 量 - ftree-vectorizer-verbose=2 从 GNU C/C++ 编译 器 请 求 更 详细 的 输出 信息 。 
LOCAL CFLAGS += -ftree-vectorizer-verbose=2 


- 旦 指定 该 函数 ，GNU C/C++ 编译 器 会 产生 一 个 输出 信息 ， 如 程序 清单 14-20 所 示 。 
该 输出 信息 将 给 出 编译 器 如 何 对 待 应 用 程序 的 每 一 循环 的 建议 。 


程序 清单 14-20 ”自动 向 量化 详细 输出 


Cygwin : Generating dependency file converter Script 
Compile thumb : Vectorization <= Vectorization.c 


jni/Vectorization.c:9: note: not vectorized: complicated access pattern. 
jni/Vectorization.c:4: note: vectorized 0 loops in function. 


jni/Vectorization.c:28: note: LOOP VECTORIZED. 
jni/Vectorization.c:22: note: LOOP VECTORIZED. 
jni/Vectorization.c:18: note: vectorized 2 loops in function. 
Executable : Vectorization 

Install : Vectorization => libs/armeabi-v7a/Vectorization 


根据 编译 器 的 详细 输出 信息 来 调整 代码 ， 从 而 给 编译 器 提供 关于 应 用 程序 中 每 一 个 循 
环 的 恰当 的 提示 。 


14.4 小结 


本 章 学 习 了 怎样 使 用 Android NDK Profiler 库 和 GNU Profiler 应 用 程序 来 分 析 原 生 应 
用 程序 。 同 时 也 探讨 了 怎样 使 用 ARM NEON 技术 来 优化 原生 应 用 程序 的 性 能 。 


